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Want to unlock the power 
of PowerPC’ microprocessors? 


Here’s the key. 





If you want to crank out code that really 
screams on PowerPC microprocessor- 
based systems, then it helps to work with 
the experts who know the PowerPC 
Architecture™ inside and out— Motorola. 
Motorola’s Software Development Kits 
for Power Macintosh™ leverage our experi- 
ence as one of the creators of the PowerPC 
Architecture. We know how to get the 
highest possible performance out of every 
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member of the PowerPC family, including 
the PowerPC 603™ and PowerPC 604™ 
microprocessors. And we build that exper- 
tise into our highly optimizing C/C++ and 
FORTRAN compilers. They’ll streamline 
your code, so your applications run cleaner 
and faster. And that can give them the edge 
in the marketplace. 

And now, when you license a Motorola 
C/C++ or FORTRAN SDK for only $3497 


MacOS 


1.0/MPW Version 






you'll get the complete Apple® MPW environ- 
ment, as well as free upgrades for a full year. 

So contact Motorola for more informa- 
tion, or to order your own Macintosh® SDK. 
And unlock the power inside PowerPC 
microprocessors. 


Call 1-800-347-8384 or 1-512-891-2999. 


Internet: ppcinfo@pets.sps.mot.com 

WWW: http://www.mot.com/PowerPC 
Applelink: motosoftware@ applelink.apple.com 
*Suggested list price in U.S. dollars. Subject to change. 
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and interface with immediate feedback, give you 
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why, with VIP-C, time really is on firs : 
Complete Development System 
_ Now develop with just one comprehensive 
system. VIP-C integrates all the tools you need 
to create stand-alone 68K and Power Macintosh 
applications—tight out of the box! Develop 
applications in a standard language using this 
intelligent, full-featured Rapid Application — 
Development (RAD) environment. No more © 
‘moving from tool to tool. No more dependence 
on non-standard languages. 
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In this electronic age, the art of communication has become both easier and more complicated. Is it any surprise that we prefer e-mail? If you have 
any questions, feel free to call us at 805/494-9797 or fax us at 805/494-9798. 
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By Scott T Boyd, Editor-at-Large 
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Under a clear night sky, high in the Colorado Rockies, far 
away from the usual trappings of techno-society, I sit, quietly 
writing C++ code while the rest of the world sleeps. Many 
years of conditioning make this the perfect time to work. 
Unfortunately, it’s right in the middle of the first vacation I’ve 
taken in a couple of years (and a family get-together, at that). 

Object oriented programming — it’s all the rage. A few years 
ago, it was touted as the thing that was going to take us to the next 
level. While I’m quite happy to acknowledge many of the 
advantages, somehow I’m still stuck sitting here using up precious 
vacation time writing object oriented code. Given that, I have to 
say that OOP isn’t exactly living up to its promise. 

Why? For one thing, the tools we generally choose to use 
are crude at best. C++ just doesn’t have the set of support tools 
that Smalltalk does, nor does it share Smalltalk’s dynamic, 
interactive nature. Yet, for some reason, we seem to prefer stone 
axes. To make it even more interesting, just about the time 
someone comes up with a tool that'll handle things, someone 
else decides that the current scheme isn’t clever enough, and 
adds something to the mix (ike SOM) that makes the currently- 
good-enough tools less useful. Before we even get started, we 
find that we need all-new frameworks, and they need all-new 
view editors, debuggers, and so forth. 


When I first dove into my current project, I was handed | 


several megabytes of C++/SOM source code, written over the 
previous year or two by a small, experienced team. “What a 
great time to break out Object Master and speed-learn the 
project,” I thought. 

The project is OpenDoc-based, so it’s broken up into a 
bunch of projects in a sizeable Projector hierarchy, and MPW 
drives the build process. At the time the project was started, 
CodeWarrior was the way to go for PowerPC code (which was, 
at the time, the only way to get CFM support), so each of the 
pieces has a CodeWarrior project file, and MPW builds each 
piece into a CFM library by sending apple events to 
CodeWarrior. It’s a bit twisty, but makes sense, given the timing 
and specific technology requirements. 

Object Master seemed like just the tool for speed-learning the 
project. Even though it didn’t have a way to add all the sources in 
a nested set of folders, it eventually did a nice job of displaying 
and navigating the object hierarchy. I found there were a few 
things that were difficult to do with Object Master, and I couldn't 
figure out whether it even knew how to do some of the things I 
needed. I was surprised to find that none of the several friends 
and coworkers I asked had any significant experience with it. 

While looking for workarounds, someone suggested 
MacBrowse. While it isn’t as slick as OM, it revealed some 
serious browsing power. Nevertheless, it, too, has its limitations. 
For example, while it can give you the file name of where a 
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function is implemented (not the path, which makes the file 
name nearly useless in a multi-folder project), it can’t open the 
file, nor will it send an apple event to your editor of choice. 

Both tools do certain jobs well, but I find that I still do 
most of my editing and browsing in MPW. Its editor is not only 
finely-honed, but, by working with a single editor, I avoid the 
unfortunate synchronization problems that crop up when I have 
a file open in more than one application. There just doesn’t 
seem to be one really good way to edit/browse when working 
on projects like this just yet. Maybe this is a job for OpenDoc... 

The real stone axes come into play when PowerPC SOM 
code needs debugging. It’s no longer an issue of whether it 
compiles and links, but we’ll get to that another time. 

We've got a ways to go before the tools are up to doing the 
job so we can spend a little more time on vacation and less on 
building things that compilers, view editors, and linkers (as well 
as the rest of what ought to be in our development 
environments) should be able to do far better and faster. In the 
meantime, it’s time to start a build Gust how many times can 
this compiler recompile these header files that haven’t changed 
in recent memory, anyway?), go back outside, and enjoy 
watching the moon come up over the mountain. 


FROM THE “COULDN’T Buy A CLUE” DEPARTMENT 
I've been giving Apple a hard time lately for just not getting it 
when it comes to the hows and whys of supporting developers. 
The saga continues. This e-mail travesty wins my award for 
Completely Missing the Point: 


To: devsupport@applelink.apple.com 
I have a neat WWDC Presentation CD. One problem. No Persuasion player. I’ve looked 
everywhere. The MacOS SDK has version 1.01 which will not open the documents on 
the Presentation CD. HELP! 
From: Developer Support Center 
We received your email regarding the WWDC Presentations CD and the inability of 
Persuasion Player 1.01 to recognize it. I apologize for the delay in my response. I’ve 
been waiting for more information to give you. Unfortunately, you do have to use the 
full Persuasion application, Persuasion 3.0 in order to recognize the files on the WWDC 
CD. Your local software dealer should carry Persuasion 3.0. 

Please feel free to contact me at DEVSUPPORT or 408/974-4897 if I can be of further 
assistance. 


FoopD For THOUGHT 
It’s important for everything to not know what everything else is 
doing. That’s the beauty of object oriented programming. 
— Rudy Baylor, Memphis, Tennessee 


Evidently, large corporations figured out the beauty of 
object oriented programming years ago. 
— Jim Shorts, College Station, Texas 





Got a tale of woe and intrigue? We'd love to hear it. Drop us a note at editorial@xplain.com 
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Bringing software into the world is a little 
like bringing up children. You always know 
where they start, but you seldom know 
where they’ll end up. These days, with 
illegal use of software so common, 
concerned developers have good reason to 
worry about the products of their labor. 
That’s where MacHASP © comes in. 





Like a responsible babysitter, MacHASP 
accompanies your software wherever it goes. 
With MacHASP there, your software won’t 
run out of control. Without MacHASP, in 
fact, your software won’t run at all. 


For developers, MacHASP provides the 
highest level of security and reliability. 

For legitimate users, MacHASP is a friendly 
and transparent solution. Once connected, 
they won’t even feel it’s there. 


And if your child wants to play with 

its friends, a single Net-MacHASP lets it 
run free around a local area network. But 
always under your supervision and control. 


Get serious about software 
protection. Since 1984, over one million 
HASP® keys have enabled thousands of 

PC & Mac software developers, in more 
than 60 countries, to protect their software. 
To find out why MacHASP is considered the 
best product in the market, order your 
MacHASP Developer’s Kit today. 


1-800-223-4277 
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The Professional's Choice 


North Aladdin Software Security Inc. 
America Tel: (800) 223 4277, 212-564 5678 
Fax: 212-564 3377 
E-mail: sales@hasp.com 


Intl Office Aladdin Knowledge Systems Ltd. 
Tel: 972-3-537 5795, Fax: 972-3-537 5796 
AppleLink: ALADDIN.KNOW 
E-mail: aladdin@aladdin.co.il 


United Aladdin Knowledge 
Kingdom Systems UK Ltd. 
Tel: 01753-622266, Fax: 01753-622262 


France Aladdin France SA 
Tel: 1 40 85 98 85, Fax: 1 41 21 90 56 








© Aladdin Knowledge Systems Ltd. 1985-1995 (4.95) PowerPC is a trademark of Motorola. Mac & the Mac OS logo are trademarks of Apple Computer, Inc., used under license 
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By Neil Ticktin, Publisher 





AN UPDATE FROM MACTECH 


For some time now, we’ve been working on a number of 
projects at the magazine to allow us to move to the next level. 
Finally now, after months of effort, we are starting to see the 
fruits of those efforts, and we wanted to share them with you. 

First, there were the mundane things like a corporate 
reorganization, moving to new offices, and other infrastructure 
related activities - all of which are aimed at further 
strengthening the magazine and the services that we provide to 
you. But, there have been more interesting projects — like 
bringing MacTech to the web, new Internet support, as well as 
a major revamping of our editorial process. 


MACTECH NET SUPPORT 

Over the last several issues, you’ve heard us talking about how to 
put yourself on the net, give yourself a web presence, and cool 
places to check out on the net — but, you’ve not seen as much 
MacTech Magazine support as you might expect. Why? Well, 
partly, we’ve been focusing on some of those aforementioned 
mundane issues. And partly, we wanted to have the “right” type of 
net presence — including finding the right vendor to partner with. 

As of this writing, we’ve come to an agreement with an 
Internet provider to give you access to our servers at rates up to 
384k. We've finally locked in the mactech.com domain name, 
and we’re bringing our servers up in the weeks to come. By 
the time that you read this, we should have up and running: 





http://www.mactech.com 
ftp://ftp.mactech.com 


So, grab your browser or ftp client and take a look — you 
should be in for a pleasant surprise. 


What's going to be there? Well, the obvious stuff — the 
latest URLs relevant to Macintosh developers, source code files, 
utilities, header files, Sprocket, information sheets on the 
magazine, tools, books, utilities, etc... But, we’re also going to 
experiment with putting much of the magazine’s history (many 
of the articles from the first 10 years) on the web — if it works 
well for all of us, we'll make it a permanent feature. This is 
similar to the MacTech CD —- but even though we have some 
solid bandwidth to the net, the CD will continue to be much 
faster. Take a look at the site, and let us know what you think. 
Our web and ftp sites are meant to be living breathing beasts 
that are there to serve the developer community. We'll be 
making regular changes to it. And, if you want something that 
you don’t see, let us know. If it makes sense, we'll do it! 

And, for those of you who have suffered from Netcom’s 
horrible service (MacTech’s provider for a long time now), 
you'll be glad to know that we are dumping their service as fast 
as we can. You'll be able to get into our servers — and with 
solid bandwidth. Of course, feel free to prove me wrong by 
accessing us regularly! :) 


Our NEW EDITORIAL APPROACH 

For the past 11 years, MacTech Magazine has always taken an 
individual and sometimes laid back approach to editorial. In 
more recent years, the editorial process was focused around a 
single editor at the magazine. This editor would either review 
articles randomly submitted by those in the developer community 
or go out into developer community to get an individual article 
written. In some cases, there were regular columnists who wrote 
articles on a monthly basis in a specific area. 


continued on page 55 


http://www.mactech.com 


Need we say more? 


(Ok - it will be available by August 1, 1995) 
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By Dave Mark, MacTech Magazine Regular Contributing Author 


Last month, we added code to our 
SprocketPicText project to implement 
the Style and most of the Size 
submenus that appear underneath the 
Text menu when a TTextWindow is 
the frontmost window. This month, 
we're going to finish up the $ize menu 
by implementing the Other... item. 
We'll also add code to implement the 
Font submenu. Finally, we'll add the 
code to the TPictureWindow to 
implement the two items in the 
Picture window that appears 
whenever a TPictureWindow is the 
frontmost window. 


A DLOG anp 4 DITL 

We'll start off by adding a single DLOG 
resource and its associated DITL 
resource to SprocketStarter.rsrc. The 
two resources will implement a dialog 
that prompts the user to type in a new 
font size. The dialog will be brought up 
when the user selects Other... from 
the $ize menu. 


e Start by duplicating last month’s 
SprocketStarter folder (be sure you 
remove objects first if you care about 
disk space). 

Don't duplicate the Sprocket 
folder, since it hasn’t changed from 
last month. Last month’s Sprocket- 
Starter folder was named 
“SprocketPicText.04/25/95”. Name 
the new copy 
“SprocketPicText.05/31/95”. 

Open up your new Sprocket- 
Starter folder and launch either the 68K 
or PowerMac SprocketStarter project. 
When your project window appears, 
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Sprocket Menus, Part 4 


double-click on the file named SprocketStarter.rsrc to launch your 
favorite resource editor. 


e Create a new DLOG with a resource ID of 1000, a top of 71, 
left of 97, bottom of 146, and a right of 303. Be sure you 
select the modal dialog window type. 

e Create a DITL with a resource ID of 1000. 

e Create a pushbutton (item#1) with the text OK, a top of 42, 
left of 184, bottom of 62, and a right of 253. 

e Create a pushbutton (item#2) with the text Cancel, a top of 
42, left of 99, bottom of 62, and a right of 168. 

e Create a static text item (item#3) with the text Font size:, 
a top of 13, left of 13, bottom of 29, and a right of 81. 

e Create an editable text item (item#4) with no text, a top of 
13, left of 91, bottom of 29, and a right of 250. 


Figure 1 shows the finished dialog, as displayed by 
Resorcerert. 





Figure 1. The DLOG and DITL resources, 
as displayed by Resorcerer. 


TEXTWINDOW.H 
Quit your resource editor, saving your changes, and return to 
CodeWarrior. Now open the file TextWindow.h and make these 
changes: 


e Add these lines to the top of the file, just before the enum: 
#include <Fonts.h> 
const long kCancelButtonPressed 


const shortiNumberEditTextField = 
const short kGetNumberDialogResID 


e Add these member function declarations to the 


SPROCKET MENUS, PART 4 


TTextWindow class: 


DoNumberDialog( void ); 
SetOtherMenuItemString( void ); 

virtual void PascalStringCat( Str255 dest, Str255 source ); 
virtual void AdjustFontMenu( void ); 

virtual Boolean DoMenuSelection( short menu, short item ); 


virtual long 
virtual void 


TEXTWINDOW.CP 


Close TextWindow.h and open the file TextWindow.cp. Make 
these changes: 


e Addto the file the member function 
TTextWindow: : DoNumberDialog () 
Here’s the source code: 

long 


TTextWindow: :DoNumberDialog( void ) 
({ 


Boolean dialogDone = false; 
ptr2z55 text; 

Handle itemHandle; 

short itemHit, itemType; 
Rect itemRect; 

long returnValue; 


DialogPtr dialog; 


dialog = GetNewDialog( kGetNumberDialogResID, NULL, 
(WindowPtr)-1L ); 


if ( dialog == NULL ) 
return kCancelButtonPressed; 


SetDialogDefaultItem( dialog, ok ); 
SetDialogCancelItem( dialog, cancel ); 


NumToString( (long)fCurrentFontSize, text ); 


GetDialogItem( dialog, iNumberEditTextField, &itemType, 
&itemHandle, &itemRect ); 
SetDialogItemText( itemHandle, text ); 


SelectDialogItemText( dialog, iNumberEditTextField, 0, 32767 ); 
ShowWindow( dialog ); 


do 
{ 
ModalDialog( NULL, &itemHit ); 


if ( itemHit == ok ) 
{ 
GetDialogItem( dialog, iNumberEditTextField, &itemType, 
&itemHandle, &itemRect ); 
GetDialogItemText( itemHandle, text ); 


StringToNum( text, &returnValue ); 


if ( (returnValue < kMinimumFontSize) | 
(returnValue > kMaximumFontSize) ) 
{ 
SysBeep( 20 ); 
SelectDialogItemText( dialog, iNumberEditTextField, 
0, 32767 ); 
itemHit = iNumberFditTextField; 
} 
else 
dialogDone = true; 
} 
else if ( itemHit == cancel ) 
{ 
returnValue = kCancelButtonPressed; 
dialogDone = true; 
} 
} while ( ! dialogDone ); 
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_ DisposeDialog( dialog ); 


return returnValue; 


} 


This function implements the dialog box whose resources you 
created earlier. The dialog allows the reader to enter a new font 
size for the frontmost text window. The user must enter a size 
between kMinimumFontSize and kMaximumFontSize, 
otherwise we'll beep and highlight the editable text field. 

We'll start off by converting the current text size, stored in 
the data member fCurrentFontSize, into a Str255 and 
we'll place the Str255 version of the number in the dialog’s 
editable text field. We'll then highlight the text field so if the 
user wants to type a new value, they don’t have to select the 
text first to replace it. 

Inside the dialog loop, if the user presses the OK button, 
we'll convert the text field to a long, then check to be sure it’s 
in range. If so, we'll set dialogDone to true so we drop 
out of the loop. 

If they hit the Cancel button, we'll set the return value to 
kCancelButtonPressed, which has been pre-defined as 
OL, which we know won't be a legal font size. 

Finally, once we drop out of the loop, we'll dispose of the 
dialog and return returnValue. 


e Add to the file the member function 
TTextWindow: :PascalStringCat () 
Here’s the source code: 
void 
TTextWindow: :PascalStringCat( Str255 dest, Str255 source ) 
{ 


unsigned chari, destStringLength, sourceStringLength; 


destStringLength = dest([0]; 
sourceStringLength = source[0]; 


if ( sourceStringLength <= 0 ) 
return; 


for ( i=l; i<=sourceStringLength; i++ ) 
dest [itdestStringLength] = source[i]; 


dest[0] += sourceStringLength; 


Much like the function strcat(), this function appends 
the source pascal string on to the end of thepascal string 
already in dest. The length byte from source is deleted and 
the length byte of dest is incremented to reflect its new length. 

This function is called by SetOtherMenuItemString () 
which we'll add next. 


e Add to the file the member function 
TTextWindow: :SetOtherMenultemString() . 
Here’s the source code: 


void 
TTextWindow: :SetOtherMenultemString( void ) 
{ 


Str255 menultemStr = "\pOther ("; 
Str255 numberStr; 
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NumToString( (long) fCurrentFontSize, numberStr ); 


PascalStringCat( menuItemStr, numberStr ); 
PascalStringCat( menultemStr, "\p)..." ); 


gMenuBar->SetItemString( cFontSizeOther, menulItemStr ); 


This function changes the Other... item in the Size 
menu to reflect the current text size. For example, if the current 
size is 37, the menu item should read Other (37).... Note that 
the $ize menu we've implemented here is not my invention. It 
comes from the pages of Inside Macintosh and represents the 
standard you should use in your own applications. 

SetOtherMenultemString() starts off by defining a 
Str255 named menuItemStr with the text “Other (’. We'll 
then convert the current size to a pascal string and append it to 
menultemStr. Finally, we'll append the pascal string “)...” to 
menultemStr then call the TMenuBar member function 
SetItemString() to change the item associated with the 
command cFontSizeOther to menultemStr. 


e Add a call of SetOtherMenuItemString() to the 
end of the member function AdjustSizeMenu(). 
AdjustSizeMenu() gets called when a mousedown 
occurs in the menu bar. 


e Add to the file the member function 
TTextWindow: :DoMenuSelection() 
Here’s the source code: 


Boolean 
TTextWindow: :DoMenuSelection( short menu, short item ) 


Str255  itemString; 
short fontNumber; 


if ( menu == mTextFont ) 


GetMenuItemText( fgFontSubMenu, item, itemString ); 
GetFNum( itemString, &fontNumber ); 
SetPort( fWindow ); 
TextFont( fontNumber ) ; 
InvalRect( &fWindow->portRect ); 
return true; 
} 
else 
return false; 


DoMenuSelection() gets called before any of the 
command dispatching functions, giving you a chance to handle 
menus that contain unregistered items. Since there is no way 
to construct a CMNU resource for the Font menu (how would 
we assign command numbers when we don’t know how many 
or which fonts are installed?), we'll handle selections from the 
Font menu in this function. 

Before you read on, take a look at the function this function 
overrides, TWindow: :DoMenuSelection(). Note that it 
simply returns false. If DoMenuSelection() returns 
false, Sprocket converts the menu selection to a command 
number and handles it that way. If DoMenuSelection() 
returns true, Sprocket assumes the menu selection has been 
processed and does nothing more. 


10 SPROCKET MENUS, PART 4 


DoMenuSelection() first checks to be sure the 
selection was from the Font menu. If so, it converts the selected 
item to a font number, then calls TextFont() to set the font 
for the associated fWindow, forces a redraw, and returns true. 

Next, we’re going to make some changes to the function 
DoMenuCommand(), our menu command dispatcher that 
gets called if DoOMenuSelection() returns false. 


e Add a declaration of the variable newSize at the top of 
TTextWindow: :DoMenuCommand (): 


long newSize; 


e Still in TTextWindow: :DoMenuCommand (), edit the 
cFontSizeOther case in the switch statement to 
read: 

case cFontSizeOther: 
newSize = DoNumberDialog() ; 
if ( newSize != kCancelButtonPressed ) 
SetNewTextSize( newSize ); 


return true; 
break; 


This case gets executed when Other (xx)... is selected from 
the $ize menu. We'll start by calling DoNumberDialog() 
to prompt the user for a new size. If a new size was entered, 
we'll call SetNewTextSize() to set the new size. 

Now we need to add the code that places the check mark 
next to the current font in the Font menu. 


e Add a call of the function AdjustFontMenu() to the 
member function 
TTextWindow: :AdjustMenusBeforeMenuSelec 
tion(). Here’s the new version of 
TTextWindow: :AdjustMenusBeforeMenuSelec 
tion(): 

void 

TTextWindow: :AdjustMenusBeforeMenuSelection( void ) 

{ 

AdjustFontMenu() ; 


AdjustSizeMenu() ; 
AdjustStyleMenu() ; 


e Add the member function 
TTextWindow: :AdjustFontMenu () to the file. 
Here’s the source code: 


void 
TTextWindow: :AdjustFontMenu( void ) 


short fontNumber, numFonts, i; 
Str255 fontName, itemName; 


fontNumber = fWindow->txFont; 
GetFontName( fontNumber, fontName ); 


numFonts = CountMItems( fgFontSubMenu ); 
for ( i=1; i<=numFonts; it+ ) 


{ 
GetMenuItemText( fgFontSubMenu, i, itemName ); 
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if ( EqualString( itemName, fontName, true, true ) ) 
CheckItem( fgFontSubMenu, i, true); 

else 
CheckItem( fgFontSubMenu, i, false); 


AdjustFontMenu() turns the current font family id 
into its name. Next, CountMItems () is called to return the 
number of items in the Font menu. The for loop steps 
through each of the items, checking to see if the item is equal 
to the font name. If so, the item gets a check mark. If not, the 
item does not get a check mark. 


PICTURE WINDOW.H 
Our final task is to add the code that implements the two items 
in the Picture menu, Centered and Upper Left. 
Centered causes the picture to be drawn centered in the 
picture window and Upper Left causes the picture to be 
pressed against the upper-left corner of the window. 


e Close TextWindow.cp and open the file PictureWindow.h. 


e Add the declaration of the data member 
fIsPictureCentered to the TPictureWindow 
class declaration: 


Boolean fIsPictureCentered; 


e Add the declarations of the member functions 
DoMenuCommand () and 
AdjustMenusBeforeMenuSelection() to the 
TPictureWindow class declaration: 


virtual Boolean DoMenuCommand( unsigned long menuCommand ); 
virtual void AdjustMenusBeforeMenuSelection( void ); 


PICTUREWINDOW.CP 
Close PictureWindow.h and open the file PictureWindow.cp. 


e Add the code that initializes fIsPictureCentered to 
the TPictureWindow constructor: 


fIsPictureCentered = true; 


° In the function TPictureWindow: :Draw(), edit the 
last two lines of code so Draw() looks like this: 

void 

TPictureWindow: :Draw(void) 

{ 


PicHandle pic; 
Rect f£; 


r = fWindow->portRect; 
EraseRect( &r ); 


if ( fDraggedPicHandle == nil ) 
pic = this->LoadDefaultPicture() ; 
else 
pic = fDraggedPicHandle; 
if ( flsPictureCentered ) 
{ 


this->CenterPict( pic, &r ); 
} 
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else 
{ 
r = (**pic).picFrame; 
OffsetRect( &r, - r.left, - r.top ); 
} 


DrawPicture( pic, &r ); 


} 


Basically, we’ve made Draw() 


fIsPictureCentered. 


depend = on 


e Add the member function 
TPictureWindow: :DoMenuCommand () to the file. 
Here’s the source code: 


Boolean 
TPictureWindow: :DoMenuCommand( unsigned long menuCommand ) 
{ 
switch ( menuCommand ) 
{ 
case cCentered: 
fIsPictureCentered = true; 
SetPort( fWindow ); 
InvalRect( &fWindow->portRect ); 
return true; 
break; 


case cUpperLeft: 
fIsPictureCentered = false; 
SetPort( fWindow ); 
InvalRect( &fWindow->portRect ); 
return true; 
break; 
} 


return false; 


This code gets called in response to a selection from the 
Picture menu. 


e Add the member function 
TPictureWindow: :AdjustMenusBeforeMenuSelection () 
to the file. Here’s the source code: 


void 
TPictureWindow: :AdjustMenusBeforeMenuSelection( void ) 
{ 
if ( flsPictureCentered ) 
{ 
gMenuBar->EnableAndCheckCommand( cCentered, true, true ie 
sMenuBar->EnableAndCheckCommand( cUpperLeft, true, false ); 
} 
else 
{ 
gMenuBar->EnableAndCheckCommand( cCentered, true, false ); 
gMenuBar->EnableAndCheckCommand( cUpperLeft, true, true ); 
} 
} 


Depending on the value of fIsPictureCentered, this 
code places a check mark next to the appropriate item in the 
Picture menu. 


SPROCKETSTARTER.CP 
Several months ago, when we first started this program, we 
added code to the function HandleMenuCommand() in 
SprocketStarter.cp that beeped when either of the Picture 
items was selected. Since we now handle these two cases 
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inside the file PictureWindow.cp (as it should be done), we 
need to delete the two commands from the case statement in 
HandleMenuCommand () inside SprocketStarter.cp. 
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¢ Close the file PictureWindow.cp and open the file 
SprocketStarter.cp. 







e Find the function HandleMenuCommand(). Inside the 
Switch statement, delete the cases (all the way down to 
the break) for cCentered and cUpperLeft. 







RUNNING SPROCKETSTARTER 

Well, that’s about it. Now’s the time to test your new creation. 
Select Run from the Project menu. When it runs, 
SprocketStarter will create a new text window, and the Text 
menu will appear at the end of the menu bar. Click on the 
Text menu, then make a selection from the Font submenu 
(Figure 2). The font of the frontmost text window should 
change and, the next time you select from the Font submenu, 
the check mark should appear next to this new font. 
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Figure 2. The Fant submenu, showing the checkmark by 
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Geneva with Chicago selected. 
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Next, select Other (18)... from the Size submenu (we 
set up18 as the default font size). The font size dialog will 
appear, with the number 18 in the editable text field. Type 0 
and click the OK button. You'll hear a beep and the 0 will be 
highlighted. Type 37 and click the OK button (Figure 3). This 
time, your new font size is accepted and the text in the text 
window is redrawn showing the new font size. 


sR em a EER ee EE 


Font size: 





Figure 3. The font size dialog that appears when you select 
Other (xx)... from the Size submenu. 


Once again, pull down the Text menu and bring down the 
Size submenu. Notice that the last item now reads Other 
(37)... and that the check mark has moved to this item (Figure 4). 









Larger 
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“Other (47)... 


Figure 4. The Size submenu with the Other (37)... item 
selected and checked. 


Finally, create a picture window, then select one of the 
two items from the Picture menu that appears. With each 
selection, the picture in the picture window should be redrawn 
to match the selection and the check mark should appear next 
to the last selected item. 
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Figure 5. The Picture menu. 
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About the only thing left to do with this code is to make the 
sizes in the $ize menu appear in outline font if they are available 
on the current machine or in regular font if that size is not available. 
Take some time to add this code. A good place to add the code is 
in the function TTextWindow: :SetUpStaticMenu (), after 
you set up the static member fgSizeSubMenu. You'll need to 
use the functions SetItemStyle() and RealFont() for 
each of the 6 sizes in the menu. 


Wuat’s NEXT 
I hope the last few columns have given you an appreciation 
for the complexity and coolness of a framework. One thing 
I've grown to appreciate is the incredible amount of work it 
must have been for Dave Falkenburg to build Sprocket. Way 
to go, Dave! 

I’m not sure what topic we'll be tackling next month. I’ve 
been thinking about building a small PowerPlant project, just to 
explore the differences between Sprocket and PowerPlant. On 
the other hand, I’ve really got a hankering to build a tool palette 
using Sprocket. And there’s this cool OpenDoc part I've been 
fiddling with. Any preferences? Send some email my way... 

See you next month! 
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DiFF- WARRIOR 


Authors frequently use a software tool to compare different 
versions of the same document and identify what changes 
have been made between versions. Something like the well- 
known diff utility for programmers, but operating on a words 
instead of a lines. This month your Challenge is to write a 
simplified version of such a file comparison tool. 

The prototype of the code you should write is: 


#define ulong unsigned long 


typedef enum { 
/* describes type of text change between old and new versions of text */ 
deletedText=0, insertedText, movedText } DiffType; 


typedef struct { 
DiffType type; 
/* The meaning of the remaining fields depends on type. 
For type == deletedText: 
rangeStart - offset in oldText of first char deleted 
rangeEnd - offset in oldText of last char deleted 
position - offset in newText before which text would be inserted to convert 
newText into oldText 
For type == insertedText: 
rangeStart - offset in newText of first char inserted 
rangeEnd - offset in newText of last char inserted 
position - offset in oldText before which text would be inserted to convert 
oldText into newText 
For type == movedText: 
rangeStart- offset in oldText of first char moved 
rangeEnd- offset in oldText of last char moved 
position- offset in oldText before which text would be inserted to convert 
oldText into newText 
| 
ulong rangeStart; 
ulong rangeEnd; 
ulong position; 
} DiffRec; 


short /* numDiffsFound */ FindWordDifferences ( 
char *oldText, /* pointer to old version of text */ 
char *newText, /* pointer to new version of text */ 
ulong numOldChars, /* number of characters in oldText */ 
ulong numNewChars, /* number of characters in newText */ 


Here’s how it works: Each month we present a new 
programming challenge here. First, write some code that solves 
the challenge. Second, optimize your code (a lot). Then, submit your solution 
to MacTech magazine. We choose a winner based on code correctness, speed, 
size, and elegance (in that order of importance) as well as the submission 
date. In the event of multiple equally desirable solutions, we'll choose one 
winner (with honorable mention, but no prize, given to the runner up). The 
prize for each month’s best solution is a $100 credit in the MacTech Mail 
Order Store and a limited-edition, “The Winner! MacTech Programmers 
Challenge” T-shirt (not available in stores anywhere). 

Unless stated otherwise in the problem statement, the following rules apply: 
All solutions must be in ANSI compatible C. Use only pure C code. We disqualify 
entries with any assembly in them (except for challenges specifically stated 
otherwise). You may call any Macintosh Toolbox routine (e.g., it doesn’t matter if 
you use NewPtr instead of malloc). We test entries with compiler options set to 
disable FPU use (for 680x0 code) and to enable all available speed optimizations. 
The compiler to be used and the target instruction set (680x0 or PowerPC) will be 


DiffRec diffs[], /* pointer to preallocated array where text differences are to 


be stored */ 
ulong maxDiffRecs /* number of DiffRecs preallocated */ 
FindWordDifferences should store a DiffRec in the diffs 
array for each sequence of words that were deleted or moved 
from oldText, and for each sequence inserted into newText. So, 
for example, if newText and oldText contained the following 
characters ... 


oldText->The quick brown fox jumps over the lazy dog. 
newText->The brown and white lazy fawn jumps over the dog. 


... you would return the value 5 and store the following into 
the diffs array: 


diffs[0]={deletedText, 4, 9, 4} (deleted "quick ") 
diffs[1]={insertedText,10,19,16} (inserted "and white m) 
diffs[2]={movedText, 35,39,16} (moved "lazy ") 
diffs[3]={deletedText, 16,18,25} (deleted "fox") 

diffs [4]=(insertedText,25,28,16) (inserted "fawn") 


The solution to this problem is clearly not unique. For 
example, each problem has a trivial solution where all of the 
oldText is deleted, and all of the newText is inserted. To encourage 
nontrivial and optimal solutions, selection of the winner will be 
based on the quality of the FindWordDifferences job you do, as 
well as how quickly you find a solution. Quality will be measured 
first by the number of characters deleted, inserted, and moved (the 
sum of the (rangeEnd-rangeStart+1) values in your DiffRec array), 
and next on the number of differences found (numDiffsFound), 
with smaller being better in both cases. The fastest solution within 
10% of the best quality score (both parameters) will be declared the 
winner, These criteria place a premium on finding movedText (as 
opposed to deletedText / insertedText pairs) and on finding larger 
contiguous sections of inserted / deleted text (as opposed to 
sequences of smaller changes). 


stated in the problem. Limit your code to 60 characters per line; 
this helps with e-mail gateways and page layout. 

We publish the solution and winners for this month’s Programmer’s 
Challenge two months later. All submissions must be received by the 10th 
day of the month printed on the front cover of this issue. 

You can get a head start on the challenge by reading the online version. 
We post it to the online services at the same time that we post source code. 
We make every effort to have it online no later than when the magazines are 
mailed, but we’re unable to guarantee that it will be online by any given date. 

Mark solutions “Attn: Programmer's Challenge Solution” and send it by 
e-mail to one of the Programmer’s Challenge addresses in the “How to 
Communicate With Us” section on page 2 of this issue. Include the solution, 
all related files, and your contact info. 

MacTech Magazine reserves the right to publish any solution entered in 
the Programmer’s Challenge. Authors grant MacTech Magazine the exclusive 
right to publish entries without limitation upon submission of each entry. 
Authors retain copyrights for the code. 
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Eddy Award Winner for Best New Developer Tool 
— MacUser Editors Choice Awards, 1993 


“A distinct improvement over ResEdit.” 
— MacTech / MacTutor 


“Resorcerer’s data template system is amazing!” 
— Bill Goodman, author of Compact Pro 


*Nuke ResEdit! Resorcerer is mission-critical for us.” 
— Dave Winer, Userland Frontier 


“The color pixel editors are wonderful! A work of art!” 
— Dave Winzler, author of Microseeds Redux 


“Every Macintosh developer should own a copy of Resorcerer.” 
— Leonard Rosenthol, Aladdin Systems 


“Resorcerer will pay for itself many times over in saved time and effort.” 
— MacUser review 


“The template that disassembles ‘PICT’s is awesome!” 
— Bill Steinberg, author of Pyro! and PBTools 


“Resorcerer proved indispensible in its own creation!” 
— Doug McKenna, author of Resorcerer 


“,..a wealth of time-saving tools.” 
MacUser Revieu, Dec. 1992 


RESORCERER 
Version 1.2.4 The Resource Editor for the Macintosh Wizard 


ORDERING INFO e New ‘cicn’, ‘ppat’, ‘crsr’, ‘acur’, ‘pitt’, ‘clut’ editors 

¢ Powerful icon family editing (all 9 icon types) 

¢ Color pixel anti-aliasing, dithering, and lots more 

Needs: >Mac Plus, > Sys 4.2, 1MB ¢ Complete ‘PICT’ disassembly and reassembly 

Likes: >Mac Plus, > Sys 7.0, 2MB New 1.2 Features: « ragga ware ROM resource browsing toa 
re , 17 e emplate field parsing types now supporte 

32-bit clean, AU/X compatible e New insertion & deletion template field types 

e Text-only ‘PICT’ resources 

e Lots of improvements throughout 





Price: $256 (decimal) 
(Educational, quantity, or 
other discounts available) 


e Easier, faster, more Mac-like, and more productive than ResEdit 
e Safer memory-based, not disk-file-based, design and operation 


Includes: 500 page manual e All file information and common commands in one easy-to-use window 
60-day Money-Back Guarantee ¢ Compares resource files, and even edits your data forks as well 
Domestic UPS ground shipping e Visible, accumulating, editable scrap 

e Searches and opens/marks/selects resources by text content 
Payment: Check, PO's, or Visa/MC ¢ Makes global resource ID or type changes easily and safely 


¢ Builds resource files from simple Rez-like scripts 

¢ Most editors DeRez directly to the clipboard 

e All graphic editors support screen-copying or partial screen-copying 

¢ Hot-linking Value Converter for editing 32 bits in a dozen formats 

¢ Its own 32-bit List Mgr can open and edit very large data structures 

e Templates can pre- and post-process any arbitrary data structure 

¢ Includes nearly 200 templates for common system resources 

Downloadable Demos/Updaters: e TMPLs for Installer, MacApp, QT, Help, AppleEvent, OCE, GX, etc. 

AppleLink: Software Sampler e Full integrated support for editing color dialogs and menus 

AOL: Software Libs/Development e Try out balloons, ‘icth’s, lists and popups, even create C source code 

CompuServe: MACDEV/Tools | ¢ Integrated single-window Hex/Code Editor, with patching, searching 
¢ Editors for cursors, versions, pictures, bundles, and lots more 

e Well-designed, helpful developer tools being added all the time 

¢ Relied on by thousands of Macintosh developers around the world 


Extras (call us): 
COD, FedEx, UPS Blue/Red, 
International Shipping 


or call us. 





MATHEMASSTHETICS, INC. 
P.O. Box 298 ¢ Boulder * CO * 80306-0298 * USA 
Phone: (303) 440-0707 ¢ Fax: (303) 440-0504 
AppleLink/AmericaOnline: RESORCERER « Internet: resorcerer@aol.com 


ee 





Now for the fine print. Notice that the comparison is 
based on words, not just on characters (look at “fox” and 
“fawn” above), so be careful when calculating offsets. Words 
are delimited by white space (spaces, CR, NL, tabs), or 
punctuation. Extra/missing white space and/or punctuation 
should also result in a DiffRec. Your solution should be case 
sensitive (i.e., “The” is different from “the”). You may not 
change the input text pointed to by newText and oldText. The 
DiffRec offsets calculated by your program should apply to the 
unchanged input oldText and newText (i.e., they should be 
independent of changes implied by any other DiffRecs). 
Correctness will be determined by using the DiffRecs you 
produce to convert the oldText into the newText, and vice 
versa (ignoring CRs and NLs). In doing the conversions, the 
DiffRecs will be applied in order of decreasing position / 
rangeStart value, and (in case of duplicates) in reverse order of 
the DiffRec array. Testing will use text files averaging 5-20K 
characters in size, and at least one test case will exceed 64K. 

Thanks to the generosity of Metrowerks, who provided a 
copy of CodeWarrior for use in the Challenge, and in response 
to requests from several readers, this Challenge will be scored 
using the CodeWarrior compiler. The target instruction set is 
the 680x0 family; I'll be testing on a 68040. (We'll have a 
PowerPC Challenge in a couple of months.) 

Finally, I want to express the gratitude that all Challenge 
participants feel toward Mike Scanlin for his excellent work 
writing this column. I am honored to have the opportunity to 
take over and hope to maintain the high standard Mike set. If 
any of you have suggestions on how to make the column and 
the Challenge even better, please send them to me at one of 
the Programmer’s Challenge e-mail addresses, or directly to 
boonstra@ultranet.com. 


Two Montus AGO WINNER 
Apparently there are at least a few chess players among 
MacTech Challenge readers. Of the six entries I received for 
the Check Checkmate Challenge, four worked correctly. 
Congratulations to Gary Beith (Largo, FL) for his efficient and 
instructive solution. Gary’s win is especially notable because 
this is his first entry in the Programmer’s Challenge. 

Here are the times and code sizes for the entries that 
worked correctly. Numbers in parens after a person’s name 
indicate that person’s cumulative point total for all previous 
Challenges, not including this one: 


Name time code 
Gary Beith 188 4282 
Ernst Munter (60) 260 19810 
Xan Gregg (24) 639 4242 
David Rees 2919 2604 


Gary’s solution demonstrates several features associated with 
efficient solutions. He employs an appropriate representation of 
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the problem data, including a chessboard representation that 
includes a border area, allowing efficient computation of chess 
moves with a minimum of special code for board boundaries. 
Gary takes maximal advantage of the untimed initialization 
routine, setting up move tables for each type of chesspiece. The 
problem statement provides opportunities for optimization; in 
this case, the problem is a legal chess position, and Gary uses 
that to determine whether a move places the opponent’s king in 
check. He applies knowledge of the problem domain to limit 
the number of possibilities his code examines, for example, by 
identifying which pieces are pinned and which axes of 
movement need not be considered, and in constraining the 
possible moves for the case of a king in check. Gary’s solution 
is not only an excellent one for the specific problem posed, but 
offers an instructive approach to Challenges in general. Nice job! 


Top 20 CONTESTANTS OF ALL TIME 
Here are the Top 20 Contestants for the 36 Programmer’s 
Challenges to date. The numbers below include points 
awarded for this month’s entrants. (Note: ties are listed 
alphabetically by last name — there are 25 people listed this 
month because 6 people have 20 points each.) 


1. [Name deleted] 176 
2: Karsh, Bill v1 
> Munter, Ernst 70 
4, Stenger, Allen 65 
= Larsson, Gustav 60 
6. Riha, Stepan 51 
fe Goebel, James 49 
8. Nepsund, Ronald 47 
9. Cutts, Kevin 46 
10. = Mallett, Jeff 44 
11. Kasparian, Raffi 42 
12. Vineyard, Jeremy 40 
13. Darrah, Dave 41 
14. Gregg, Xan = 
15. Landry, Larry 29 
16. — Elwertowski, Tom 24 
17. Lee, Johnny. 22 
18. — Noll, Robert 22 
19. Anderson, Troy 20 
20. Beith, Gary 20 
21. Burgoyne, Nick 20 
22. Galway, Will 20 
23. — Israelson, Steve 20 
24. Landweber, Greg 20 
25. Pinkerton, Tom 20 


There are three ways to earn points: (1) scoring in the top 
5 of any Challenge, (2) being the first person to find a bug in a 
published winning solution or, (3) being the first person to 
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We added to our laundry list. 


Since the initial release of BBEdit over two years ago, Bare Bones Software has set a new standard for 
innovation and technological leadership. BBEdit has won acclaim and awards from industry players, 
reviewers, and customers, with capabilities such as: 





¢ Native PowerPC™ code to speed editing, searching and transformation of text. 

* Scriptability via AppleScript, Frontier 3.0, or any OSA-compatible scripting system. 

¢ Support for Macintosh Drag and Drop to speed text editing and other tasks. 

¢ Unique “Find Differences” command to interactively compare files, folders or projects. 

¢ Integrated support for Symantec C++, Metrowerks CodeWarrior, THINK Reference, 
Toolbox Assistant, and MPW ToolServer. 

¢ Non-stick coating for easy clean-up. 

¢ Support for the AOCE Standard Mailer package, for the ability to read, compose, and 
send PowerTalk mail. 

¢ Powerful search and replace capabilities, with optional “grep” pattern matching and 
mulfi-file search and replace. 

¢ Integrated PopupFuncs™ technology, for easy navigation of Pascal, C/C++, Rez, 
68K assembler, and Fortran source files. 

¢ Quickdraw GX printing support, for advanced job-control capabilities. 


For those who are looking for the best way to create HTML documents for publishing on the 
World Wide Web, BBEdit offers: 


e “Soft” text wrapping for easy composition. 

¢ Integration with Internet services and “helper” tools, via the Internet Config system. 

¢ HTML tools to speed and automate the creation of WWW content. 

¢ Automated translation of DOS/Windows and Unix-format text files. 

e Easy import and export of word processor document formats via the XTND™ system. 


With the release of BBEdit 3.5, we have made our laundry list even longer, with useful and time- 
saving features such as: 


¢ Support for the CW7 (CodeWarrior version 1.3) unified development environment. 

e “File Groups” for managing collections of related files. 

¢ Improved “Find” dialog for easier execution of search and replace operations. 

e “Quick Search” window for interactive search operations in the front document. 

e Enhanced AppleScript support, with the ability to script BBEdit extensions. 

¢ Floating “Document List” for instant access to any open window. 

e Sparkle XP-29 for even better stain resistance. 

e “Scripts” menu, for quick access to AppleScript scripts and scripting tools. 

¢ Enhanced PopupFuncs technology, with support for HTML, Perl, Tcl, ScriptX, and improved 
Pascal/Object Pascal support. 

¢ Improved documentation, including Apple Guide, enhanced balloon help, and all-new user manual. 


BBEdit 3.5 is delivered to you on CD-ROM, along with documentation and the latest in tools, demos, 
product information, SDKs, and updates from Bare Bones Software and other industry leaders. 








Add something to yours. 





If BBEdit is your choice for HTML composition and you mention BBEdit in your home page, 
send us the URL and we will send you something to add to your laundry list. Fora limited 
time, we are offering a free “BBEdit: It Doesn't Suck” t-shirt to Web authors who use 

BBEdit to create their pages. Simply fill out the t-shirt coupon below and send it back to us. 


Bare Bones Software, Inc., Home Page T-shirt Offer, P.O. Box 108, Bedford, MA 01730, USA Bare Bones 


Software, Inc. 


























Name: Send my t-shirt to: 
URL of your home page: 

Phone: 
T-shirt size (circle one) : L XL XXL 

E-Mail: 








BBEdit Home Page T-Shirt Offer valid through December 31, 1995. All entries are subject to verification. One t-shirt per customer. Allow 3 weeks for delivery. 


For more information about BBEdit, contact us as listed below. For information about purchasing 
BBEdit, see the “Mail Order Store” section at the back of this issue. 


BBEdit. It doesn’t suck. 


For a free demo disk, 
send us email. 
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Internet: bbsw@netcom.com eealor ated for 
CompuServe: 73051,3255 VOW em Fernie BMUG 
Applelink: BARE.BONES v™ 

EEE eWorld: BareBones Mac , cae RobuCT 





Software, Inc. ftp:/ /ftp.std.com/vendors/bbsw / 





© 1995 Bare Bones Software, Inc. P.O.. Box 108 Bedford, MA 01730 voice: 508.651.3561 fax: 508.651.7584 Our lawyers insist we say: BBEdit, PopupFuncs and our spiffy logo are trademarks 
of Bare Bones Software, Inc. Mac and the Mac OS logo are trademarks of Apple Computer, Inc., used under license. PowerPC is a trademark of International Business Machines Corporation. 
All other trademarks and registered trademarks are properties of their respective holders. BBEdit is dolphin-safe and organically grown without the use of hormones or pesticides. 















CXBase Pro 


A powerful ANSI C database engine for 
C and C++ programmers 


Based on the database engine used by Apple AOS for their 
eWorld content publishing software, CXBase Pro represents the 
State of the art in data storage and retrieval technology. 

CXBase Pro has all the tools you need to develop any kind of 
application that needs its own database engine. 


The philosophy behind CXBase Pro is to provide a simple, 
consistent, and powerful API that lets you work in whatever way 
you choose. CXBase Pro Is delivered with full source code, giving 
you maximum flexibility and security. CXBase Pro is completely 
cross platform, allowing you to access one set of files from any 
platform. And CXBase Pro has been engineered from the ground up 
for maximum performance. 








suggest a Challenge that I use. The points you can win are: 


1st place 20 points 
2nd place 10 points 
3rd place 7 points 
4th place 4 points 
5th place 2 points 
finding bug 2 points 
suggesting Challenge 2 points 


Here is Gary’s winning solution: 


CHESSMOVEENUMERATOR.C 
Copyright ©1995 Gary Beith 


Objective: To determine all legal moves (excluding castling and en passant captures) 
available for a given chess position. It is NOT required to single out intelligent moves! 


SSS SS ee ee oe ae a a a ee ae ee et a ae Se ee See Se Se Se SD Se Se aD Sane Se cant ne nes anes Gane oa Gane Gan ND Ones oom Same Gms oma ames oe */ 
OP cece eee ps eg oes eedeeseneeeaneeeeseseee 
Items required by the problem statement 
Seg ty ess ciunaned ture seanedl windadecinvusiersdsedo-ae */ 
#pragma options ( mc68020, !mc68881, require_protos ) 
#pragma options ( pack_enums, align_arrays ) 
typedef enum { rowA = 0, rowB, rowC, rowD, rowE, rowF, rowG, 
rowH } Row; 
typedef enum { coll = 0, col2, col3, col4, col5, col6, col7, 
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Cross-platform multimedia database technology for professional developers 


Test drive before you buy - Full-featured $49 demo available! 
Both products come in a demonstration version, including the complete manual, a full-featured library limited only by file size, and access 
to all the function calls. You can use It as long as you like, and if you decide to buy the full package you get credit for the price of the demo. 


TSE International | laandwarsstr.51 : 1013 BV Amsterdam, Holland : tel: 31 20 638-6507 | fax: 31 20 620-4933 | AppleLink : TSE.INT 


Apple, AOS, eWorld, Power Macintosh, and Quadra are trademarks of Apple Computer, Inc. 


The AMTCX 
Database Extension 


An integrated, cross-platform database engine for 
the Apple Media Tool Programming Environment 


The AMTCX Database Extension is a set of classes for the 
Apple Media Tool Programming Environment that give you 
access to CXBase Pro. The classes let you store traditional record 
and field-based data, as well as multimedia data. All the 
programming Is done using AML, making It very simple to use. 


More and more developers are discovering that 
database-driven titles can solve many run-time [@itewaiaetimenmuls 
and production problems. The AMTCX gives you (iNeelem(cte itm iere) 
the ability to create these titles. The AMTCX 1.2 Demo CD! 

also includes a full version of CXBase Pro. 








eols |} 
typedef enum { whiteSide = 0, blackSide } Side; 
typedef enum { king = 0, queen, rook, bishop, knight, pawn } 
ChessPiece; 


Col; 


typedef struct Square |{ 
Row row; 
Col col; 
} Square; 


typedef struct PiecePosition { 


Square Sq; 

Side side; 

ChessPiece piece; 
} PiecePosition; 


typedef struct ChessMove { 


Square fromSq; 

Square tosq; 

Boolean movelsCapture; 

Boolean opponentPlacedInCheck; 
} ChessMove; 


short /* numberOfMoves */ LegalChessMoves ( 
PiecePosition piecePositionArray|[], 


short numberOfPieces, 
Side sideToMove, 
ChessMove legalMoveArray[], 
void *privateDataPtr 


); 


void InitChess(void *privateDataPtr) ; 
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Gives you the Information to Program your Best! 






~ 


Information 


he Debugger is a low and high-level symbolic 

Debugger that runs in a full multi-window 

Macintosh environment. You can trace program exe- 
cution, view the values of variables, etc. of both 68K and 
PowerPC programs. 

MacNosy is a global interactive disassembler that 
enables one to recover the source code of any Mac applica- 
tion, resource file or the ROM. 

When you compare features of the different debuggers, 
note that only one has all the below features to help you get 
your job done, and only one has MacNosy to help you debug 
any program in a full system (6.0x or System 7.x) environ- 
ment symbolically! 

It is the only debugger to use the MMU to protect your 
CODE resources and the rest of the system from the pro- 
gram you are debugging. With MMU Protection you can find 
errors when they happen, not millions of instructions later! 
(Macintoshs with 68030 CPUs only). 

The Debugger is the debugger of choice at: Adobe, 
Aldus, Claris, Electronic Arts, Kodak, Metrowerks, etc. 


WindowRecord_@465320 


WindowRecord 
port 
windowk ind 
visible 
hil i ted 
goAwayF lag 
spareF lag 
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updateRgn 


‘CGrafPor t_@465320 
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“*Regione4sso7r4 
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**Regionl4sS5960 
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titleHandle : B485918 = "Untitled-1" iH 
titleWidth 67 HEE 
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windoawPic : AIL 
refCon : $O0464F28 


An example of a structured data display window 


The Debugger V2 
& MacNosy 


by Steve Jasik 








‘thy 


ent 


Control 


Its Features Include: 


® Symbolic Debugging of any Macintosh program, ROM, or 
code resource (DRVRs, XCMDs, INITs, PDEFs, 4DEXs ..) 


® Source level debugging for Metrowerks & MPW compiled 
programs (C++, C, Pascal, Fortran, ...), and an Incremental 
Build System with instant Link for superfast development. 

® Object Inspector for MacApp 3 programs 

® Source level debugging of Think C™ projects 


® Includes a program (CoverTest) to interactively do Code 
Coverage analysis for SQA testing, etc. 


® Simultaneous Symbolic debugging of multiple “tasks” 


® Fast Software Watchpoint command to find clobbered 
variables 


® Sophisticated error check algorithms such as Trap 
Discipline (Argument Checking), Handle Zapping, Heap 
Scramble and Heap Check to detect program errors before 
they become disasters 


® Structured display of data (hypertext) with user definable 
structures while debugging 


® Conditional breakpoints to help filter out redundant 
information 


® Continuous Animated Step Mode to watch your program 
execute instruction by instruction 


® Detailed symbolic disassembly for both 680x0 and 
PowerPC with symbol names, labels, cross ref maps, - 
make it possible to ferret out the secrets of the ROM, etc. 


® "Training Wheels" for the PowerPC disassembler to help 
you learn the opcodes 


The Debugger V2 & MacNosy: $350 


Runs on all Macs. Call For Group prices or Updates. 
Visa/MC Accepted. 


Available from: Jasik, APDA, Frameworks or 
ComputerWare (800-326-0092). 


Jasik Designs - 343 Trenton Way, Menlo Park, California 94025 + (415) 322-1386 





Internet: macnosy@jasik.com ¢ Applelink: D1037 





#fdefine kMaxChessPiece pawn 


typedef Square *SquarePtr; 
typedef PiecePosition *PiecePosPtr; 
typedef ChessMove *ChessMovePtr; 


typedef enum { 
stmPawnSq0 = 0, stmPawnSql, stmPieceSqQ, stmPieceSql, 
offBoardSq0, offBoardSql, emptySq0, emptySql, 
oppPieceSq0, oppPieceSql, oppPawnSq0, oppPawnSql 

} MySquare, *MySquarePtr; 


i 
The attack flag is used to denote squares near the King known to be under attack, thus 
preventing the King from moving to them. State “0” for each square type represents 
attack flag not set, state “1” represents flag set. The attack mask is used to clear the 
flag when testing for empty squares. 

* 


#fdefine kAttackFlag 0x01 
#define kAttackMask Ox0e 


typedef char MySquareIncr, *MySqIncrPtr; 
typedef unsigned char MyAxis, *MyAxisPtr; 
typedef short MySquareDiff, *MySqDiffPtr; 


typedef struct { 


MySqIncrPtr sqIncrArrayPtr; 
MyAxisPtr axisArrayPtr; 
short numberOfAxes; 

} MyPieceTable; 

typedef struct { 
MySquarePtr Sqrur: 
MyPieceTable peTable; 
Square fromsq; 
MyAxis discAxis, pinAxis; 


} MyPiece, *MyPiecePtr, **MyPieceHandle; 


typedef struct { 


MyPieceHandle pcHandle; 
MyPieceTable peTable; 
MySquare sqType; 


} MyPieceInfo, *MyPcInfoPtr; 


ti 
My internal square numbering scheme: 
** Opponent ** 


[175] - - cea - [185] 
- = - 7 eae - 2 = . - [174] 
- « (185) = cyan = (152) 2 - - - - - 
< six more rows here > 
~ = £38) “sees @-( 20) =e = 4 & & 
[ 15] - - shee. = = ‘ = 7 = : = 
| Oj = sa oe oe 


** Side to move ** 


Numbers in parentheses indicate corners of the actual chess board. Some reasons for 
choosing this scheme: 

1. A border of at least two off-board squares is provided around the board to facilitate 
the determination of valid Knight moves. 

2. Adjacent squares in a column have an absolute index difference of 16 (efficient 
power of 2). A difference of at least 15 was required so that index values for squares 
in the same row would always differ by less than those for squares in different rows. 
3. The perspective of the side to move is used rather than that of either White or 
Black exclusively. This enables the identical move enumeration algorithm to be used 
for either side - differences such as pawn movement direction are accounted for when 
converting from and to the problem statement’s board format. 

* 


#fdefine kLowerLeftSqIndex 33 
#fdefine kMin4thRankSqIndex 81 
#tdefine kMin5thRankSqIndex 97 
#tdefine kMin8thRankSqIndex 145 
#fdefine kUpperRightSqIndex 152 
#fdefine kMaxSqIndex 185 





/* Maximum square index differential on the board = kUpperRightSqIndex - 
kLowerLeftSqIndex */ 
i#fdefine kMaxSqDiff 119 


hi 
For purposes of this program, “long move” pieces are defined as consisting of Queens, 
Rooks, and Bishops. These pieces may move as many unobstructed spaces in each of 
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their permitted directions as are available on the board. The maximum counts given 
for long move pieces and Knights allow for the potential for all eight Pawns to romote 
to such pieces. 

* 


#fdefine kMaxLongMovePieces 13 
#fdefine kMaxKnights 10 
#fdefine kMaxPawns 8 


typedef struct { 


MyPiecePtr endSTMKingPtr, endOppKingPtr, 
endSTMLMPiecePtr, endOppLMPiecePtr, 
endSTMKnightPtr, endOppKnightPtr, 
endSTMPawnPtr; 

MySquare sqArray[kMaxSqIndex + 1]; 

} MyChessBoard; 


typedef struct { 

MyChessBoard chessBoard, emptyBoard; 

MyPiece stmKing, oppKing, 
stmLMPieceArray [kMaxLongMovePieces] , 
oppLMPieceArray |kMaxLongMovePieces] , 
stmKnightArray[kMaxKnights] , 
oppKnightArray[kMaxKnights] , 
stmPawnArray [kMaxPawns] ; 


MyPiecePtr pePtrArray[kMaxSqIndex + 1]; 

Square whiteSqArray [kMaxSqIndex + 1], 
blackSqArray [kMaxSqIndex + 1]; 

SquarePtr stmSgqArrayPtr; 


MyPieceInfo stmPcInfoArray[kMaxChessPiece + 1], 
oppPcInfoArray[kMaxChessPiece + 1]; 

MySquareIncr queenSqIncrArray[2 * kMaxSqDiff + 1], 
rookSqIncrArray[2 * kMaxSqDiff + 1], 
bishopSqIncrArray[2 * kMaxSqDiff + 1]; 

Boolean knightMoveArray[2 * kMaxSqDiff + 1]; 

MyAxis queenAxisArray[4], rookAxisArray[2], 
bishopAxisArray [2]; 

MySquareDiff knightSqDiffArray [8], 
kingSqDiffArray [8]; 

} MyData, *MyDataPtr; 





Local function prototypes 


void SetUpMyChessBoard(MyDataPtr dataPtr, 
PiecePosition piecePositionArray[], 
short numberOfPieces, 
Side sideToMove) ; 


short FindChecksAndPins(MyDataPtr dataPtr, 
MySquarePtr *checkSqHandle, 
MySquareIncr *checkSqIncrPtr) ; 


void EnumerateNonKingMoves(MyDataPtr dataPtr, 
ChessMovePtr *moveHandle) ; 


void EnumerateNonKingCapturesOfCheckingPiece ( 
MyDataPtr dataPtr, 
MySquarePtr checkSqPtr, 
ChessMovePtr *moveHandle); 


void EnumerateInterpositionMoves(MyDataPtr dataPtr, 
MySquarePtr checkSqPtr, 
MySquareIncr checkSqIncr, 
ChessMovePtr *moveHandle) ; 


void EnumerateKingMoves(MyDataPtr dataPtr, 
ChessMovePtr *moveHandle) ; 





LegalChessMoves 


short LegalChessMoves(PiecePosition piecePositionArray|], 
short numberOfPieces, 
Side sideToMove, 
ChessMove legalMoveArray[], 
void *privateDataPtr) 
{ 
MyDataPtr dataPtr = privateDataPtr; 
short numberOfChecks; 
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MySquarePtr checkSqPtr; dataPtr->stmSqArrayPtr = dataPtr->whiteSqArray; 
MySquareIncr checkSqIncr; do 
ChessMovePtr movePtr = legalMoveArray; { 


sqindex = kLowerLeftSqIndex + 


SetUpMyChessBoard(dataPtr, piecePositionArray, ((posPtr->sq.row << 4) + posPtr->sq.col); 
numberOfPieces, sideToMove) ; 
peInfoPtr = (posPtr->side) ? 

dataPtr->oppPcInfoArray + posPtr->piece : 


dataPtr->stmPcInfoArray + posPtr->piece; 


numberOfChecks = FindChecksAndPins(dataPtr, &checkSqPtr, 
&checkSqIncr) ; 


sqPtr = dataPtr->chessBoard.sqArray + sqIndex; 
- (numberOfChecks == 0) if ((*sqPtr = pcInfoPtr->sqType) != oppPawnSq0) 
{ 
EnumerateNonKingMoves(dataPtr, &movePtr) ; dataPtr->pcPtrArray|[sqIndex] = 
} pePtr = (*pcInfoPtr->pcHandle)t+; 
else if (numberOfChecks == 1) 
{ pePtr-Jsq?Ptr = sqPtr; 
EnumerateNonKingCapturesOfCheckingPiece(dataPtr, pePtr-»pcTable = pcInfoPtr->pcTable; 
checkSqPtr, pePtr->»fromSq = posPtr->sq; 
&movePtr) ; pePtr->discAxis = pcPtr->pinAxis = 0; 
if (checkSqIncr) } 
{ } 
EnumeratelInterpositionMoves(dataPtr, checkSqPtr, while (++tposPtr != endPosPtr) ; 


checkSqIncr, &movePtr) ; } 
} } 


} 
/* else if (numberOfChecks == 2) . 
Only King moves are possible (if any exist). */ 





FindChecksAndPins 


EnumerateKingMoves(dataPtr, &movePtr) ; short FindChecksAndPins(MyDataPtr dataPtr, 
MySquarePtr *checkSqHandle, 


return (movePtr - legalMoveArray); /* Number of moves */ MySquareIncr *checkSqIncrPtr) 


{ 





MySquarePtr kineSqPtr, sqPtr; 
MyPiecePtr eéndPePtr, pePtr; 
setUpMyChessBoard short sqincr, stmPcSqIndex, numberOfChecks = 0; 


void SetUpMyChessBoard(MyDataPtr dataPtr, ei 
PiecePosition piecePositionArray[], Since I must report all moves which place the opponent in check, | first scan for possible 
short numberOfPieces, discovered checks. These occur when only one piece (which must belong to the side to 


Side sideToMove) 


PiecePosPtr posPtr, endPosPtr; 
short sqindex; 
MyPcInfoPtr peInfoPtr; 
MySquarePtr Sarer: 

MyPiecePtr pePtr; 


dataPtr->chessBoard = dataPtr->emptyBoard; 


posPtr = piecePositionArray; 
endPosPtr = posPtr + numberOfPieces; 


if (sideToMove) /* ==blackSide */ 
{ 
dataPtr->stmSqArrayPtr = dataPtr->blackSqArray; 
do 
{ 
sqIndex = kUpperRightSqIndex - 
((posPtr->sq.row << 4) + posPtr->sq.col); 


peInfoPtr = (posPtr->side) ? 


dataPtr->stmPcInfoArray + posPtr->piece : 


dataPtr->oppPcInfoArray + posPtr->piece; 


sqPtr = dataPtr->chessBoard.sqArray + sqindex; 
if ((*sqPtr = pcInfoPtr->sqType) != oppPawnSq0) 
{ 
dataPtr->pcPtrArray[sqIndex] = 
pePtr = (*pcInfoPtr->pcHandle)++; 


pePtr*>sqPtr = Sartr; 
pePtr->»pceTable = pcInfoPtr->pcTable; 
pePtr->fromSq = posPtr-?sq; 
pePtr->discAxis = pcePtr->pinAxis = 0; 
} 
} 
while (++tposPtr != endPosPtr) ; 
7 
else 


{ 
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move) stands between one of the mover’s long move pieces and the enemy King, and 
that piece is moved off of the line of attack. Because I am only required to analyze legal 


positions, I know that at least one piece will exist on any such line of attack. 
* 
/ 

kingSqPtr = dataPtr->oppKing.sqPtr; 


endPcPtr = dataPtr->chessBoard.endSTMLMPiecePtr; 
for (pePtr = dataPtr->stmLMPieceArray; 
pePtr < endPcPtr; pcePtrtt) 
{ 
sqdPtr = pePtr-7eqPtr: 
sqincr = pcePtr->peTable.sqIncrArrayPtr 
[kingSqPtr - sqPtr + kMaxSqDiff] ; 
if (sqIncr == 0) 
continue; /* King not “in line” with this piece */ 
sqPtr 7 sqincr; 
stmPcSqIndex = 0; 
while (*sqPtr <= emptySql) /* Not opponent's piece */ 
{ 
if (*sqPtr < emptySq0)  /*Is mover’s piece */ 
{ 
if (stmPcSqIndex) 
break; //* More than one piece in its path */ 


stmPcSqIndex = sqPtr - dataPtr->chessBoard.sqArray; 


} 
if ((sqPtr t= sqIncr) == kingSqPtr) 
{ 


/* Record line of attack for future reference */ 
dataPtr->pePtrArray[stmPcSqIndex] ->discAxis = 
(sqIncr < 0) ? -sqIncr : +sqIncr; 
break; 
} 
} 
} 


/* 


A similar analysis determines if any pieces are“pinned," i.e., they stand in the way of an 
attack on the mover’s King by an enemy piece. A pinned piece can move only along 


the line of attack (if such a move is permitted for the piece; in particular, a pinned 
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Knight is never able to move). 
a 
kingSqPtr = dataPtr->stmKing.sqPtr; 


endPcPtr = dataPtr->chessBoard.endOppLMPiecePtr; 
for (pcPtr = dataPtr->oppLMPieceArray; 
pePtr < endPcPtr; pcPtrt+t) 


sqPtr = pePtr->sqPtr: 
sqIncr = pcePtr->pcTable.sqIncrArrayPtr 
[kingSqPtr - sqPtr + kMaxSqDiff] ; 
if (sqIncr == 0) 
continue; 


if ((sqPtr += sqIncr) == kingSqPtr) 
{ 


f 
Piece is adjacent to King. The King may capture it if it is not protected by another 
piece. However, no interposition moves are possible. 
/ 
sqPtr[tsqIncr] |= kAttackFlag; 
*checkSqHandle = pcPtr->sqPtr; 
“cheekSqinerPtr = 0; 
numberOfCheckst+; 
continue; 


stmPcSqIndex = 0; 
while (*sqPtr <= emptySq1) 
{ 

if (*sqPtr < emptySq0) 

{ 


if (stmPcSqIndex) 
break; 


stmPcSqIndex = sqPtr - dataPtr->chessBoard.sqArray; 
} 


if ((sqPtr += sqIncr) == kingSqPtr) 
{ 


if (stmPcSqIndex) /* Pinned piece was found */ 
{ 
dataPtr->pcPtrArray [stmPcScIndex] ->pinAxis = 
(sqiner <0) 7 -sqincr + teqincr: 
} 


else 
{ 
King is in check “from a distance.” If the King moves, it must leave the line of attack, 
which is recorded so that interposition moves can be determined later on. 
* 
i 
sqPtr[tsqIncr] |= kAttackFlag; 
sqPtr[-sqIncr] |= kAttackFlag; 
*checkSqHandle = pePtr->sqPtr; 
*checkSqIncrPtr = sqIncr; 
numberOfChecks++; 


break; 
} 
} 
} 


Vg 
The maximum number of checks possible is two, only one of which can come from a 
Pawn or Knight. 
* 
/ 
if (numberOfChecks < 2) 


Ig 


Per ANSI standard, a sequence point occurs after the evaluation of each operand of the 


Logical Or and Logical And operators. Therefore, I can validly rely on the value of 
sqPtr being set in exactly the order specified in the next expression (and others like 
it). That is not generally true of most other operators. 

a 


if ((*(sqPtr = kingSqPtr + 15) >= oppPawnSq0) | | 
(*(sqPtr += 2) >= oppPawnSq0) ) 
{ 


*checkSqHandle = sqPtr; 


*checkSqIncrPtr = 0; 
numberOfCheckst+; 
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} 

else 

{ 
endPcPtr = dataPtr->chessBoard.endOppKnightPtr; 
for (pePtr = dataPtr->oppKnightArray; 


pePtr < endPcPtr; pePtrtt) 
{ 
sqPtr = pePtr-?sqPtr: 
if (dataPtr->knightMoveArray 
[kingSqPtr - sqPtr + kMaxSqDiff] ) 


*checkSqHandle = sqPtr; 
*checkSqIncrPtr = 0; 
numberOfCheckst+; 
break; 


return numberOfChecks; 





EnumerateNonKingMoves 


void EnumerateNonKingMoves(MyDataPtr dataPtr, 


( 


ChessMovePtr *moveHandle) 


MySquarePtr oppKingSqPtr, toSqPtr, sqPtr; 
MyPiecePtr endPcPtr, pcPtr; 
MyAxisPtr axisPtr, endAxisPtr; 


short toSqIncr, sqIncr, toSqIndex; 
ChessMovePtr movePtr = *moveHandle; 
MySqDiffPtr sqDiffPtr, endSqDiffPtr; 
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oppKingSqPtr = dataPtr->oppKing.sqPtr; 


endPcPtr = dataPtr->chessBoard.endSTMLMPiecePtr; 
for (pePtr = dataPtr->stmLMPieceArray; 
pePtr < endPcPtr; pcPtrt++) 
/* | 
The move table for long move pieces consists of a set of axes of movement for the 
particular type of piece (i.e., Queen, Rook, or Bishop). The positive and negative 
values of each axis are used as square increments, beginning at the piece’s current 
square pointer, and continuing until further movement is blocked by another piece or 
by the end ofthe board. In the event the blockage is caused by an oppenent’s piece, 
one additional move results; that of capturing the piece by moving onto its square. 
* 
/ 
exisPir = pertr-lpelaple ,axisArray? tr: 
endAxisPtr = axisPtr + pcPtr->pcTable.numberOfAxes; 
do 
{ 
if (pePtr->pinAxis && (pcPtr->pinAxis != *axisPtr)) 
continue; /* Piece is pinned on some other axis */ 


tong lncr = *axisPtr: 
do 
{ 
tosqPtr = pePir-7 Sqr er: 
do 
{ 
if (*(toSqPtr += toSqIncr) < emptySq0) 
break; /* Square off-board or holds own piece */ 


movePtr->fromSq = pcPtr->fromSq; 
movePtr->toSq = 

dataPtr->stmSqArrayPtr 

[toSqPtr - dataPtr->chessBoard.sqArray]; 
movePtr->movelsCapture = (*toSqPtr > emptySql); 


/* 

If a long move piece has a discovered check axis, it is not able to move along that axis. 
Otherwise, it would be checking the enemy King, and the position would not be legal with 
this side to move. Therefore, any move of such a piece will result in a discovered check. 


*/ 
if (pePtr->discAxis) 
( 
(movePtrtt+) ->opponentPlacedInCheck = true; 
continue; 
: } 
sqIncr = pePtr->pceTable.sqIncrArrayPtr 
loppKingSqPtr - toSqPtr + kMaxSqDiff]; 
if (sqIncr == 0) 
{ 
(movePtrt+) ->opponentPlacedInCheck = false; 
continue; 
} 
Vi 


Scan along the path to the enemy King from the target square for this move. If the first 
occupied square is that of the King, a check will result from the move; otherwise, no check. 
*/ 

sqPtrc = tosqPtr; 

do 

{ 

SsqPtr ‘t= sdlicr 
} 
while ((*sqPtr & kAttackMask) == emptySq0) ; 


(movePtr++) ->opponentPlacedInCheck = 
(sqPtr == oppKineSqPtr) : 
we (*toSqPtr <= emptySq1); 
ae i((tosdiner = <toSqiner) <-0); 
| ane (+taxisPtr != endAxisPtr):; 


endPcPtr = dataPtr->chessBoard.endSTMKnightPtr; 
for (pcePtr = dataPtr->stmKnightArray; 

pePtr < endPcPtr; pePtrtt) 
{ 
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if (pePtr->pinAxis) 
continue; 


toSqPir = pePtr=)>sqPtr; 


bi 
Unlike long move pieces, each move of a Knight may be evaluated independently from 
all of its other moves. Thus, the move table consists of a set of relative square 
differentials, each added in turn to the previous move’s square pointer, rather than 
basing all of the moves on the Knight’s current square pointer. 
* 
/ 
sqDiffPtr = dataPtr->knightSqDiffArray; 
endSqDiffPtr = sqDiffPtr + 8; 
do 
{ 
if (*(toSqPtr += *sqDiffPtr) >= emptySq0) 
{ 


movePtr->fromSq = pcPtr->fromSq; 
movePtr->toSq = 
dataPtr->stmSqArrayPtr 
[toSqPtr - dataPtr->chessBoard.sqArray]; 
movePtr->movelsCapture = (*toSqPtr > emptySql); 
(movePtr++) ->opponentPlacedInCheck = 
(pcPtr->discAxis | | 
dataPtr->knightMoveArray 
loppKingSqPtr - toSqPtr + kMaxSqDiff]); 
} 
} 
while (++sqDiffPtr != endSqDiffPtr) ; 
} 


endPcPtr = dataPtr->chessBoard.endSTMPawnPtr; 
for (pePtr = dataPtr->stmPawnArray; 
pePtr < endPcPtr; pcPtrt++) 
{ 
i 
Pawns require two different move evaluations; one for captures, and a different one 
for non-capture moves. 
*/ 
for (toSqIncr = 15; toSqIncr <= 17; toSqIncr t= 2) 
{ 
if ((pePtr->pinAxis & 
(pePtr->pinAxis != toSqIncr)) || 
(*(tosqPtr = pePtr->sqPtr + toSqiner) <= 
emptySql) ) 
{ 
continue; /* Pawn pinned or no capture available */ 
} 


toSqIndex = toSqPtr - dataPtr->chessBoard.sqArray; 
movePtr->fromSq = pcPtr->fromSq; 
movePtr->toSq = dataPtr->stmSqArrayPtr [toSqIndex] ; 
movePtr->movelsCapture = true; 
if (pcePtr->discAxis) 
{ 
(movePtrtt) ->opponentPlacedInCheck = true; 
continue; 


} 


if (toSqIndex < kMin8thRankSqIndex) 


f 
l 


(movePtrt+) ->opponentPlacedInCheck 

(((toSqPtr + 15) == oppKingSqPtr) 

((toSqPtr + 17) == oppKingSqPtr)); 
continue; 


} 





hi 

Pawn promotion brings up two interesting points. One, the value of 
“opponentPlacedInCheck” becomes ambiguous, since the Pawn can promote to a Queen, 
Rook, Bishop, or Knight, and the squares that it attacks will vary accordingly. Since a Pawn 
most often promotes to a Queen, I have chosen to set “opponentPlacedInCheck” on that 
basis. The second point concerns the “ghost image” of the Pawn after it moves. In other 
cases, it does not matter that the piece being moved is still recorded as being on its original 
square, since a line of attack to the enemy King which goes through that square must be 
blocked anyway; otherwise, the piece would have checked the King from its original 
square, and the position would be illegal. In the case of a promoted Pawn, however, this 
assumption does not hold true. Therefore, I compare the square pointer with the Pawn’s 
original position; if they match, I treat the square as though it were empty. 
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sqincr = dataPtr->queenSqIncrArray 

[oppKingSqPtr - toSqPtr + kMaxSqDiff] ; 
if (sqIncr == 0) 
{ 


(movePtrtt) ->opponentPlacedInCheck = false; 
continue; 


eqrtr = toogPte; 
do 
{ 


} 
while (((*sqPtr & kAttackMask) == emptySq0) || 
(eqPtr == poPtr=>sqPtr) ); 


sqrPtr r= sqincr; 
(movePtrt+) ->opponentPlacedInCheck = 
(sqPtr == oppKingSqPtr) ; 


if (pcePtr->pinAxis & Ox0f) /*i.e., axis not 0 or 16 */ 
continue; 


if it is not blocked and has not yet reached the fourth rank. 


a 


tooqPtr ™ pePtr=)sqaPtr: 
do 
{ 
if ((*(toSqPtr += 16) & kAttackMask) != emptySq0) 
break; 


toSqIndex = toSqPtr - cataPtr->chessBoard.sqArray; 
movePtr->fromSq = pcPtr->fromSq; 


movePtr->toSq = dataPtr->stmSqArrayPtr [toSqIndex] ; 
movePtr->movelsCapture = false; 
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if (pePtr->discAxis & 0x0f) 

{ 
(movePtr+t) ->opponentPlacedInCheck = true; 
continue; 


} 


if (toSqIndex < kMin8thRankSqIndex) 
{ 
(movePtr+t+) ->opponentPlacedInCheck = 
(((toSqPtr + 15) == oppKingSqPtr) || 
((toSqPtr + 17) == oppKingSqPtr) ); 
continue; 


sqIncr = dataPtr->queenSqIncrArray 

[oppKingSqPtr - toSqPtr + kMaxSqDiff] ; 
if (sqIincr == 0) 
{ 


(movePtr+t+) ->opponentPlacedInCheck = false; 
break; 
} 


Sq°tr = Toogrtr; 
do 
{ 
sqPtr t= sqIncr; 
} 
while (((*sqPtr & kAttackMask) == emptySq0) || 
(eqPtr =" pePtr-?>sqPtr)); 


(movePtrtt+) ->opponentPlacedInCheck = 
(sqPtr == oppKingSqPtr) ; 
break; 
while (toSqIndex < kMin4thRankSqIndex) ; 
} 


*moveHandle = movePtr; 








. EnumerateNonKingCapturesOfCheckingPiece 


void EnumerateNonKingCapturesOfCheckingPiece 


(MyDataPtr dataPtr, 
MySquarePtr checkSqPtr, 
ChessMovePtr *moveHandle) 


MySquarePtr oppKingSqPtr, sqPtr; 

short checkSqIndex, sqIncr, fromSqIncr; 
Square checkSq; 

MyPiecePtr endPcPtr, pcPtr; 

ChessMovePtr movePtr = *moveHandle; 


oppKingSqPtr = dataPtr->oppKing.sqPtr; 


checkSqIndex = checkSqPtr - dataPtr->chessBoard.sqArray; 
checkSq = dataPtr->stmSqArrayPtr [checkSqIndex] ; 


endPcPtr = dataPtr->chessBoard.endSTMLMPiecePtr; 
for (pePtr = dataPtr->stmLMPieceArray; 

pePtr < endPcePtr; pcPtrtt) 
{ 


if (pePtr->pinAxis) 
continue; 


sqPtr ™ pePtr->sqPtr; 
sqIncr = pcePtr->pcTable.sqIncrArrayPtr 
[checkSqPtr - sqPtr + kMaxSqDiff] ; 
if (sqIncr == 0) 
continue; 


do 
{ 
sqPtr += sqIncr; 


while((*sqPtr & kAttackMask) == emptySq0) ; 


if (sqPtr != checkSqPtr) 
continue; 
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movePtr->fromSq = pcPtr->fromSq; 
movePtr->toSq = checkSq; 
movePtr->movelsCapture = true; 


if (pePtr->discAxis) 
{ 


(movePtrtt) ->opponentPlacedInCheck = true; 
continue; 


sqIncr = pcePtr->pcTable.sqIncrArrayPtr 
[oppKingSqPtr - sqPtr + kMaxSqDiff] ; 

if (sqIncr == 0) 

{ 


(movePtrtt) ->opponentPlacedInCheck = false; 
continue; 


} 


do 
{ 
sqPir += sdincer; 
} 
while ((*sqPtr & kAttackMask) == emptySq0); 


(movePtrtt+) ->opponentPlacedInCheck = 
(sqPtr == oppKingSqPtr) ; 


| 
J 


endPcPtr = dataPtr->chessBoard.endSTMKnightPtr; 
for (pePtr = dataPtr->stmKnightArray; 
pePtr < endPcPtr; pcPtr++) 
if (pePtr->pinAxis == 0) 
{ 


if (dataPtr->knightMoveArray 
[checkSqPtr - pcePtr->sqPtr + kMaxSqDiff] ) 
{ 

movePtr->fromSq = pcPtr->fromSq; 

movePtr->toSq = checkSq; 

movePtr->movelsCapture = true; 

(movePtr+t) ->opponentPlacedInCheck = 
(pcPtr->discAxis | | 
dataPtr->knightMoveArray 
loppKingSqPtr - checkSqPtr + kMaxSqDiff]); 

} 
} 
} 


for (fromSqIncr = 15; fromSqIncr <= 17; fromSqIncr += 2) 
{ 
if (*(sqPtr = checkSqPtr - fromSqIncr) > stmPawnSq1) 
continue; /* Square does not contain mover’s Pawn */ 


pePtr = dataPtr->pcPtrArzay 
[sqPtr - dataPtr->chessBoard.sqArray]; 
if (pePtr->pinAxis) 
continue; 


movePtr->fromSq = pcPtr->fromSq; 
movePtr->toSq = checkSq; 
movePtr->movelsCapture = true; 


if (pcePtr->discAxis) 
{ 


(movePtrt+) ->opponentPlacedInCheck = true; 
continue; 


} 


sqPtr = checkSqPtr; 
if (checkSqIndex <¢ kMin8thRankSqIndex) 
{ 
(movePtrtt) -PopponentPlacedInCheck = 
(({sqPtr + 15) == oppKingSqPtr) 
((sqPtr + 17) == oppKingSqPtr)); 
continue; 





sqIncr = dataPtr->queenSqIncrArray 
[oppKingSqPtr - sqPtr + kMaxSqDiff] ; 

if {(sqIncr == 0) 

{ 
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} 


(movePtrtt) ->opponentPlacedInCheck = false; 
continue; 


do 
( 
sqPtr t= sqIncr; 
} 
while (((*sqPtr & kAttackMask) == emptySq0) || 
(sqPtr == pePtr-2sqPtr)) : 


(movePtr+t) ->opponentPlacedInCheck = 
(sqPtr == oppKingSqPtr) ; 


*moveHandle = movePtr; 


} 





EnumeratelInterpositionMoves 


void EnumerateInterpositionMoves(MyDataPtr dataPtr, 


{ 


MySquarePtr checkSqPtr, 
MySquareIncr checkSqIncr, 
ChessMovePtr *moveHandle) 


MySquarePtr oppKingSqPtr, toSqPtr, sqPtr; 
short toSqIndex, sqIncr; 

Square tosq; 

MyPiecePtr endPcPtr, pcePtr; 

ChessMovePtr movePtr = *moveHandle; 


oppKingSqPtr = dataPtr->oppKing.sqPtr; 


, 


This “monster” do-loop repeats for each square which lies between the checking piece 
and the mover’s King. 


a 


toSqPtr = checkSqPtr + checkSqIncr; 


do 


{ 


toSqIndex = toSqPtr - dataPtr->chessBoard.sqArray; 
toSq = dataPtr->stmSqArrayPtr [toSqIndex] ; 


endPcePtr = dataPtr->chessBoard.endSTMLMPiecePtr; 
for (pePtr = dataPtr->stmLMPieceArray; 
pePtr < endPcPtr; pcPtrt+) 
{ 
if (pcePtr->pinAxis) 
continue; 


SqPtr = -pePtr-?sqarce: 
sqincr = pePtr->pcTable.sqIncrArrayPtr 
[toSqPtr - sqPtr + kMaxSqDiff] ; 
if (sqincr = 0) 
continue; 


while ((sqPtr += sqIncr) != toSqPtr) 
{ 
if ((*sqPtr & kAttackMask) != emptySq0) 
goto NextLMPiece; /* Break while, continue for */ 
} 


movePtr->fromSq = pcPtr->fromSq; 
movePtr->toSq = toSq; 
movePtr->movelsCapture = false; 


if (pePtr->discAxis) 


(movePtrtt) ->opponentPlacedInCheck = true; 
continue; 


sqIincr = pePtr->pceTable.sqIncrArrayPtr 
loppKingSqPtr - sqPtr + kMaxSqDiff] ; 

if (sqIncr == 0) 

{ 


(movePtr+t) ->opponentPlacedInCheck = false; 
continue; 


} 
do 
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{ 
sqPtr += sqIncr; 
} 
while ((*sqPtr & kAttackMask) == emptySq0) ; 


(movePtr+t) ->opponentPlacedInCheck = 
(sqPtr == oppKingSqPtr) ; 


NextLMPiece: 


’ 


endPcPtr = dataPtr->chessBoard.endSTMKnightPtr; 
for (pePtr = dataPtr->stmKnightArray; 
pePtr < endPcPtr; pcePtrtt+) 
{ 
if (pcePtr->pinAxis == 0) 
{ 


if (dataPtr->knightMoveArray 
[tosSqPtr = pePtr-PéqPtr + kKMaxsqDift)) 
{ 

movePtr->fromSq = pcPtr->fromSq; 

movePtr->toSq = toSq; 

movePtr->movelsCapture = false; 

(movePtrtt) ->opponentPlacedInCheck = 
(pePtr->discAxis | | 
dataPtr->knightMoveArray 
[oppKingSqPtr - toSqPtr + kMaxSqDiff]) ; 


/* 

Pawn interposition is not possible if the square in the same column in the previous 
row does not contain a mover’s Pawn, AND any one of the following is true: 

1. The square where interposition is to take place is not on the fourth rank, 

2. The square in the same column on the third rank is not empty, 


3. The square in the same column on the second rank does not contain a mover’s Pawn. 


: 
/ 
if ((*(sqPtr = toSqPtr - 16) > stmPawnSql) && 
((toSqIndex >= kMin5SthRankSqIndex) || 
(toSqIndex < kMin4thRankSqIndex) | 
((*sqPtr & kAttackMask) != emptySq0) | | 
(*(sqPtr -= 16) > stmPawnSq1))) 
{ 
continue; 


pePtr = dataPtr->pcPtrArray 
[sqPtr - dataPtr->chessBoard.sqArray] ; 
if (pePtr->pinAxis) 
continue; 


movePtr->fromSq = pcePtr->fromSq; 
movePtr->toSq = toSq; 
movePtr->movelsCapture = false; 


if (pePtr->discAxis & Ox0f) 

{ 
(movePtrtt) ->opponentPlacedInCheck = true; 
continue; 


BGPEL = :CosdPtr: 
if (toSqIndex < kMin8thRankSqIndex) 
{ 
(movePtrtt) ->opponentPlacedInCheck 
(((sqPtr + 15) == oppKingSqPtr) 
((sqPtr + 17) == oppKingSqPtr)); 
continue; 





sqIncr = dataPtr->queenSqIncrArray 
[oppKingSqPtr - sqPtr + kMaxSqDiff]; 

it (eqiner == 0) 

{ 


(movePtrtt) ->opponentPlacedInCheck = false; 
continue; 


do 
{ 
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SsqPtr += sdincer; 


| 
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while (((*sqPtr & kAttackMask) == emptySq0) || 
(Sqrer == pertr > sqPtr) 


(movePtrtt) ->opponentPlacedInCheck = 
(sqPtr == oppKingSqPtr) ; 
} 
while (*(toSqPtr += checkSqIncr) >= emptySq0) ; 


*moveHandle = movePtr; 


} 





EnumerateKingMoves 


void EnumerateKingMoves(MyDataPtr dataPtr, 
ChessMovePtr *moveHandle) 


{ 


MySquarePtr stmKingSqPtr, sqPtr, toSqPtr; 
short discAxis, sqincr; 

MySqDiffPtr sqDiffPtr, endSqDiffPtr; 
MyPiecePtr endPcPtr, pcPtr; 

ChessMovePtr movePtr = *moveHandle; 


stmKingSqPtr = dataPtr->stmKing.sqPtr; 
discAxis = dataPtr->stmKing.discAxis; 


sqPtr = dataPtr->oppKing.sqPtr; 

sqIncr = stmKingSqPtr - sqPtr; 

if ((sqIncr >= -34) && (sqIncr <= +34)) 

{ 
/* 
The opposing King might be within range of squares to which this King could move, so 
set the attack flag for all squares the opposing King attacks. This will include some 
squares to which this King cannot move - it did not seem worth the trouble to code a 
fancy algorithm which ensures that only squares to which this King can move have the 
attack flag set. In most normal chess positions (excluding the endgame), the two Kings 
are at opposite ends of the board, so this code won’t be executed very often anyway. 


sqDiffPtr = dataPtr->kingSqDiffArray; 
endSqDiffPtr = sqDiffPtr + 8; 
do 
{ 
‘(sqrtr += “eqDitr Ptr) 


= kAttackFlag; 
} 
while (++sqDiffPtr != endSqDiffPtr) ; 

} 


toSqPtr = stmKingSqPtr; 


sqDiffPtr = dataPtr->kingSqDiffArray; 
endSqDiiiPir = eqDiriePir + 8; 
do 
{ 
i 
The King cannot move to this square if: 
1. It is off-board or occupied by mover’s own piece, 
2. It is flagged as known to be under attack, 
3. It is within capture range of an enemy Pawn. 
* 
/ 
if ((*(toSqPtr += *sqDiffPtr) < emptySq0) || 
(*toSqPtr & kAttackFlag) || 
(*(sqPtr = toSqPtr + 15) >= oppPawnSq0) || 
(*(sqPtr += 2) >= oppPawnSq0) ) 
{ 
continue; 


} 
| he 
*/ 
endPcPtr = dataPtr->chessBoard.endOppLMPiecePtr; 


for (pcePtr = dataPtr->oppLMPieceArray; 
pePtr < endPePer? pePtrt?) 


The square is also blocked if a long move piece or Knight attacks the square. 


{ 
SqPtr = pePtr-vsqrirs 
sqIncr = pcPtr->pcTable.sqIncrArrayPtr 
[toSqPtr - sqPtr + kMaxSqDiff] ; 
if (sqIncr) 
{ 


do 
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MacForth Plus & «~ ne 


sqincr = toSqPtr - stmKingSqPtr; 
(movePtrtt) ->opponentPlacedInCheck = 


Power od relate ((discAxis != sqIncr) && (discAxis != -sqincr)); 


NextKingMove: 


The Language of Innovation is now | 
available native on the Power Macintosh. while (++sqbiffPtr != endSqDiffPtr) ; 


*moveHandle = movePtr; 








FEATURES @ High Level Graphics 
@ Royalty Free Turnkey @ Toolbox Support 
Compiler = Extensive Documentation jnitChess 
= Text Editor ® Reasonable Upgrades eee ee ea ee eRe 
; /! SSSSSSSSssssssssSsssssssSsSsSSSSSSSSSSSSSSSSSSSSSSSSSSSS= 
® Online Glossary Tool ® Optional Tools Disks Untimed initialization routine 
e system 7 Compatibility e Mac Forth Plus $1 99 SSSSSSSSSSSSSSSSSSSSSSSSSS= SSS SSS SSS SSS SSS SSS SSS SSS T= 7 
™ 68020 Assembler m= Power MacForth $199 void InitChess(void *privateDataPtr) 
r { 
m 68881/2 Co-processor MyDataPtr dataPtr = privateDataPtr; 
support MySquarePtr sqPtr; 
int index, sqRow, sqCol; 
SquarePt whiteSqPtr, blackSqPtr; 
MySqIncrPtr posQueenSqIncrPtr, negQueenSqIncrPtr, 


posRookSqIncrPtr, negRookSqIncrPtr, 
posBishopSqIncrPtr, negBishopSqIncrPtr; 
Boolean *posKnightMovePtr, *negKnightMovePtr; 


Creative Solution, Ime. 


4701 Randolph Road, Suite 12 


lia 
301 984-0262 oF + O00-FORTHLOK (orders) Quoting from the problem statement: “The privateDataPtr parameter will be the same 


; 2710. «als pointer provided to InitChess." Therefore, I can set pointers based on its value in my 
ae OEE EEs Ene DOMES! private data structure. This would not be possible if the parameter were guaranteed 
only to point to a copy of the same data, but not necessarily to have the same value. 





( 
if ((sqPtr += sqIncr) = toSqPtr) 
goto NextKingMove; 


/* 
Set an “audit trail” of attacked squares for this piece. Most of these attack flags will be 


useless, but they cost very little to set, and they make the test for empty squares easier. 


If one does happen to fall in a square next to the mover’s King, it will save time by 
removing that square from consideration immediately. 
* 
/ 
*sqPtr |= kAttackFlag; 


while (*sqPtr == emptySql): 
} 
} 


endPcPtr = dataPtr->chessBoard.endOppKnightPtr; 
for (pePtr = dataPtr->oppKnightArray; 
pePtr < endPcPtr; pcPtrtt) 
{ 
if (dataPtr->knightMoveArray 
[toSqPtr - pcPtr->sqPtr + kMaxSqDiff] ) 


goto NextKingMove; 
} 


movePtr->fromSq = dataPtr->stmKing.fromSq; 
movePtr->toSq = 

dataPtr->stmSqArrayPtr 

[toSqPtr - dataPtr->chessBoard.sqArray] ; 
movePtr->movelsCapture = (*toSqPtr > emptySql); 


* 


The only checks which can result from a King move are checks. 
/ 
if (discAxis = 0) 
{ 
(movePtrtt) ->opponentPlacedInCheck = false; 
} 
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/ 


dataPtr->emptyBoard.endSTMKingPtr = &dataPtr->stmKing; 
dataPtr-DemptyBoard.endOppKingPtr = &dataPtr->oppKing; 
dataPtr->emptyBoard.endSTMLMPiecePtr = 
dataPtr->stmLMPieceArray; 
dataPtr->emptyBoard.endOppLMPiecePtr 
dataPtr->oppLMPieceArray; 
dataPtr->emptyBoard.endSTMKnightPtr 
dataPtr->stmKnightArray; 
dataPtr->emptyBoard.endOppKnightPtr = 
dataPtr->oppKnightArray; 
dataPtr->emptyBoard.endSTMPawnPtr = 
dataPtr->stmPawnArray; 


i 
Initialize the empty chess board structure and the square coordinate arrays. 
a 
sqPtr = dataPtr->emptyBoard.sqArray; 
for (index = 0; index <= kMaxSqIndex; indextt) 
*“sqPtrt+ = offBoardSq0; 


sqPtr = dataPtr->emptyBoard.sqArray + kLowerLeftSqIndex; 
whiteSqPtr = dataPtr->whiteSqArray + kLowerLeftSqIndex; 
blackSqPtr = dataPtr->blackSqArray + kUpperRightSqIndex; 
for (sqRow = 0; sqRow < 8; sqRowtt) 
{ 

for (sqCol = 0; sqCol < 8; sqColt++) 

{ 


*sqPtrtt = emptySq0; 
whiteSqPtr->row = sqRow; 
blackSqPtr->row = sqRow; 
(whiteSqPtrt+) ->col = sqCol; 
(blackSqPtr--)->col = sqCol; 

} 

sqPtr t= 8; whiteSqPtr += 8; blackSqPtr -= 8; 


f° 
Initialize the piece information arrays. 
yi 
dataPtr->stmPcInfoArray|[king].pcHandle = 


MACTECHMAGAZINE ® AuGUST 1995 


} 
else if (sqCol == 0) 
{ 


*posQueenSqIncrPtrtt VLG; 
*negQueenSqIncrPtr-- = -16; 
*posRookSqIncrPtrt+ = +16; 
*negRookSqIncrPtr-- =: 163 
*posBishopSqIncrPtrtt+ = 0; 
*negBishopSqIncrPtr-- = 0; 
*posKnightMovePtrt+ = false; 
*negKnightMovePtr-- = false; 

} 

else if (sqRow == sqCol) 

{ 
*posQueenSqIncrPtrtt+t = T17; 
*negQueenSqIncrPtr-- = -1/7; 
*posRookSqIncrPtrtt = . 03 
*negRookSqIncrPtr-- = Os 
*posBishopSqIncrPtrt+ = +17; 
*negBishopSqIncrPtr-- = -17; 
*posKnightMovePtrt+ = false; 
*negKnightMovePtr-- = false; 

} 

else 

{ 
*posQueenSqIncrPtrtt 0; 
*negQueenSqIncrPtr-- = 0; 
*posRookSqIncrPtrtt 0; 
*negRookSqIncrPtr- - = 0} 
*posBishopSqIncrPtrtt = 0; 
*negBishopSqIncrPtr-- = 0; 


/* A Knight moves only to those squares within two rows and columns that a Queen 
cannot reach. */ 
if ((sqRow < 3) && 
(sqCol > -3) && (sqCol < 3)) 


*posKnightMovePtrtt = true; 


*negKnightMovePtr-- = true; 
} 


else 


{ 
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*posKnightMovePtr++ = false; 


*negKnightMovePtr- 


dataPtr->queenAxisArray | 
dataPtr->queenAxisArray [ 
dataPtr->queenAxisArray [ 
dataPtr->queenAxisArray [ 


dataPtr 
dataPtr 


>rookAxisArray [0] 
>rookAxisArray[1] 


dataPtr 
dataPtr 


>bishopAxisArray [0] 
>bishopAxisArray [1] 


dataPtr 
dataPtr 
dataPtr 
dataPtr 
dataPtr 
dataPtr 
datertr 
dgarercr 


>knightSqDiffArray [ 
>knightSqDiffArray [ 
>knightSqDiffArray [ 
>knightSqDiffArray [ 
[ 
[ 
[ 
[ 





>knightSqDiffArray 
>knightSqDiffArray 
>knightSqDiffArray 
>knightSqDiffArray 


dataPtr 
dataPtr 
dataPtr 
dataPtr 
dataPtr 


>kingSqDiffArray| 
>kingSqDiffArray[ 
>kingSqDiffArray[ 
>kingSqDiffArray[ 
[ 
[ 
[ 
[ 


>kingSqDiffArray 
dataPtr->kingSqDiffArray 
dataPtr->kingSqDiffArray 
dataPtr->kingSqDiffArray 
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2 
2 
4 
5 
6 
7 
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In seeking ways to Improve our own development process, FGM Inc., a seasoned Macintosh developer, began 


focusing on streamlined dialog creation. Among our objectives: increased productivity and consistency across 


programming styles; reduced development time, code size, and learning curve; and code simplification. 


As a result of our quest, the ideas for OpenDialog were born. 


To support creation of modal, movable modal, and modeless dialogs, FGM consolidated a set of functions into an 


API which simplifies Macintosh programming tasks and enhances visual interface results. 


Inside Mac compliance 


Automatic Radio Button Groups 
Multi-BITL 
Selected ()List  (@) Popup 
Multi-Platform /68k & PPC 
(o Metrowerks CodeWarrior 
(7) Symantec THINK C 
(1) Apple MP Ww 


support for all standard DITLs 
automatic radio button grouping 
radio button item-ordering independence 
® user-definable item handlers 
® user-definable event handlers 
® scrollable edit fields 
multiple dialog refcons 
automatic control group framing 
built-in command key equivalents 
® default window font overrides 


Complete User-Definability 
Custom Default Buttons 
Custom Itern Callbacks 
Cursor-Sensitive Help 
Mouse-Sensitive Cursor 
Custom ‘window Font 

Edit-Field Filtering 

3-digit 
3.2-digit 

Scrolling edit 

The scroll bars on this text edit field 

automatically become active when 


the entered data reaches the bottom 
of the bounding rectangle | 


® integrated progress bar 

® built-in edit filters 
built-in support for date/time, lat/lon, integer/ 
floating point fields 
context-sensitive help 
default button override 

® user-definable callback procedures for all item 
types 

® item refcons 

® built-in keyboard focus, and more... 


OpenDialog supports development in both the 68k and PowerPC native modes. All routines are C and 
Pascal-callable and compatible with Think C, CodeWarrior, and MPW programming environments. 


Tolewexelureceyay 
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FGM Inc. 


Price 131 Elden Street, Suite 308 


Herndon, VA 22070 
703.478.9881 
Fax 703.478.9883 


$259 opndlg42@fgm.com 


after 9/1/95 








By Dennis R. Cohen, Claris Corp. 
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Metrowerks aggressively 
pursues cross-platform 
support. 


Ivs hard to believe that almost a year- 
and-a-half has passed since I was first 
asked to write a preview of Metrowerks 
CodeWarrior for MacTech and (not 
counting interim “extra” releases on CD 
and via the electronic networks) the 
sixth CodeWarrior has hit the shelves 
and mailboxes. During that time 
CodeWarrior has been extremely well- 
received by the developer community 
and has played such a significant role in 
Power Macintosh software development 
that MacUser magazine awarded 
Metrowerks the “Eddy” for Macintosh 
Software Product of the Year. 


Wuat You GET AND Wuat’s NEW 
This release continues the tradition of 
promises fulfilled and surprise bonuses 
to the extent that not everything could 
fit on one CD — so they shipped two. 

On the main CD we find the 
expected items: new releases of C/C++ 
and Pascal Integrated Development 
Environments (IDEs) for both the 68K 
and Power Macintosh as well as new 
releases of PowerPlant, the Metrowerks 
Debugger (which my boss refers to as 
“CodeVoyeur”), and the Profiler and 
ZoneRanger utilities. There are also 
MPW tool versions of the C/C++ 
compiler and Linker for both platforms. 
Metrowerks has also supplemented their 
collection of third-party SDKs, tools, and 
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demos with a bunch of neat new freeware, shareware, and 
demo software and the QuickView developer’s kit. The CD also 
contains MacApp 3.1.3 and 3.3al. Finally, they have added 
more scriptability to the environment and provided some very 
useful scripts for importing and exporting projects — including 
being able to create an MPW makefile from a project file. 

The second CD contains a number of items which were 
originally scheduled to be extra-cost options or part of a more 
expensive “Platinum” version such as the Magic Cap compiler 
and development tools and the Microsoft Windows cross- 
compiler and development system as well as late additions to 
the CodeWarrior 6 materials, such as a PowerPC version of 
MacApp2 for the Object Pascal programmers among you. You 
also get the OpenDoc DR2 release and a preview of the next 
iteration of CodeWarrior’s IDE, where you can use different 
compilers and tools from within one IDE rather than having a 
separate (though virtually identical) IDE for each compiler, a 
prerelease of Code Fragment Manager for 68K support, and the 
first look at the CodeWarrior Browser. 


66 Metrowerks has continued 
their 1.5 year tradition 
of responsiveness and support 
with this edition”? 


WHAT CHANGED? 
The main changes to the C/C++ compilers are the addition of 
C++ exception handling and Standard Template Library (STL) 
support. The biggest change to the Pascal compiler is that it is 
now both “ready for prime time” and an Object Pascal compiler. 
The environment now always uses stationery (unless you hold 
down the option key when choosing “New Project...” from the 
menu). CodeVoyeur has added a “Memory” window which 
gives a hex/ascii memory display and some initial support for 
Drag Manager debugging as well as becoming interoperable 
with QC from Onyx Technology. PowerPlant has been 
significantly enhanced to use exceptions and to include new 
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classes for AOCE, a standard movable modal dialog, and 
isolating event dispatching; additionally, a number of classes 
(such as LAction and LUndoer) have seen major reworking. 
Metrowerks is also including a number of prebuilt resources for 
your use with PowerPlant projects that support many 
commonly used portions of PowerPlant. 

One of the larger changes is to the documentation. While 
most of the documentation is still in DocViewer format, much 
has been made available in QuickView format, the Altura 
Hypertext Engine used for Apple’s Macintosh Programmer’s 
Toolbox Assistant. In addition to all this, printed documentation 
is now available in book form for $39.95, ten dollars less than 
was previously charged for the looseleaf manuals. 


How Does It ALL Work? 
The first thing that should be said is that the format of libraries 
and precompiled headers has changed and that old code needs 
to be recompiled or re-precompiled. Apple has also made 
further (in some people’s view, gratuitous) minor changes to 
the Universal Interfaces that will possibly require some editing 
work to get your code to compile properly. 

Some of the little changes to the environment make tasks a 
lot simpler. A good example of this is the Find... dialog. 
Checkboxes have been added for System Headers, Project 
Headers, and Project Sources and selecting them will add the 
expected files to the list of files to be searched. In addition, you 
can name and save sets of files that you might wish to search in 
the future and then just select them from the popup menu. 
Going one step further, you can drag a folder or group of 
files/folders from the Finder into the scrolling list area to add 
them to the list of files to be searched. Similarly, you can 
remove files from the list by dragging their names to the Trash 
or double-click on a name to open that file. 

This all makes getting the list of files to be searched a lot 
easier, but Metrowerks also added a “Batch” checkbox to the 
dialog and now you get a window with all the “hits” in it, 
similar to an Error/Warning window, from which you can select 
the ones you wish to bring forward. 

The compilers have all gotten more robust and a shade 
faster — a build that took 372 seconds under CW5 is now taking 
me 358 seconds under CW6 on a Quadra 800 using the C 
compiler, and a 179 second Pascal build under CW5 (that didn’t 
work right) now takes 161 seconds (and functions correctly). 

PowerPlant is being heavily used by Metrowerks, 
internally, as it is the framework used for CodeVoyeur, Zone 
Ranger, and the “experimental” 1.3 environment contained on 
the second CD. 
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151 file(s) 


Metrowerks has continued their 1.5 year tradition of 
responsiveness and support with this edition, almost to the 
point where you don’t comment on it because you expect it. 
One of the nicest surprises, from my perspective, was receiving 
the Magic Cap development package with the Magic Cap 
emulator originally scheduled as a separate product. The 
development tools are MPW-based rather than an IDE, but they 
are quick. Unfortunately, the Magic Cap simulator looks for an 
FPU and refuses to run without one. This necessitates installing 
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SoftwareEPU on a Power Macintosh to get it to run and what 
you get is incredibly slow, however, put it on a Quadra 800 
and it just screams. If I ever find the free time, | will be creating 
something with this package because Magic Cap looks like a 
“fun” environment in which to play. 

The Windows32/WindowsNT cross-development package 
is an IDE and includes a two-machine debugger so that you 
debug your app on the Mac while it is running on the PClone. 
Creating this environment meant the editor had to deal 
properly with DOS text files and their carriage-return/linefeed 
end-of-line convention as well as the Macintosh carriage-return 
only convention. This was also put into the Macintosh 
environment editors, relieving those of us who must 
occasionally deal with PC files of the “missing character” boxes 
at the start of each line. Not being a Windows developer, my 
only exposure to the environment was at Apple’s World Wide 
Developer Conference, where Metrowerks personnel walked 
me through the complete edit-compile-transfer-run/debug 
scenario with a couple of example applications. I felt that it 
was a pretty smooth and reasonable cross-development 
package and am told that it works properly with Microsoft 
Foundation Class Library; however, I am not necessarily a good 
judge on this subject. 
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Examine Discipline Testing Log 


CONCLUSION 


Metrowerks is continuing to lead the way in providing 
affordable, quality development tools with excellent support in 
a timely manner. With Symantec having released a very solid 
PowerPC compiler (Symantec C+ 8.0), maybe we'll start seeing 
the competition develop which I hoped for last year. 
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By Steve Palmen, tshirt2b@halcyon.com 


Apple Dylan 


Apple Dylan: What does 
the future bold? 





[As we put this issue to bed, the Dylan 
developer community is buzzing with 
rumors on the future of Apple Dylan. 

As you may remember, Apple 
intends to ship “Early Dylan” this fall. 
This implementation is built on top of 
Macintosh Common Lisp and is capable 
of targeting Power Macintosh, but not 
running native on Power Mac. To date, 
Apple Dylan has been developed by the 
former ATG group in Cambridge, MA. 

As of this writing, the report is that 
Apple may be closing it’s Cambridge office 
(of about 20 people) focused on Dylan, 
and moving the efforts to Cupertino. It 
isn’t clear if nor when this is going to 
happen — although it won't likely happen 
until at least October when Early Dylan is 
released. What also isn’t clear is who will 
be working on Apple Dylan — new folks in 
Cupertino? the current folks in 
Cambridge? or a combination? 

Apple is working on the plans now 
for the future of Apple Dylan. Hopefully, 
by the time you read this, we'll have an 
idea. We’re being told that this is a good 
thing for Apple Dylan — we hope they are 
right. As with all “sea changes” — time 
will tell. Stay tuned... Ed. —- nst] 











To paraphrase Lennon & McCartney, “J saw a film today (ob 
boy), the C++ Army had just won the language war. ” Then 
again... maybe not. Over the last few months I’ve had the 
opportunity to explore an early alpha implementation of Apple 
Dylan. This article examines some of the basic aspects of the 
Dylan language and presents a brief overview of the Apple 
Dylan development environment. 


A BrieF History OF DYLAN 

In the late 80’s, Apple’s Advanced Technology Group (ATG) 
saddled themselves with the task of creating a new language, 
one that would combine the best qualities of dynamic 
languages like Smalltalk™ and Lisp, with those of static 
languages like C++. Recognizing that a language definition 
alone wasn’t sufficient to meet the challenges of developing the 
next ever-more complex generation of software, ATG further 
committed the Dylan team (now a part of the Developer 
Products Group) to developing an attendant development 
environment that would enable the rapid prototyping and 
construction of real-world applications. 

The result of Apple’s largess? A object-oriented dynamic 
language where everything is an object — forget about whether 
a method argument is passed by value, reference or pointer, it’s 
not an issue, Automatic memory management which 
renders memory leaks and dangling pointers as bugs of the 
past. A language wherein the degree of type checking is 
controlled by you, the programmer. Robust exception 
handling capabilities which enable you to intelligently respond 
to failures. 

In addition to these language features, Apple Dylan includes 
an integrated development environment that supports 
incremental compilation and linking which enables you to 
suspend a running program, alter its source, recompile and link 
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just the affected source, and then resume program execution. 
Apple has also extended the language standard to include cross 
language support which enables you to use existing C- 
compatible libraries in your Dylan application. 

Apple Dylan also includes an application framework 
tailored for building (surprise!) Macintosh applications. Apple 
Dylan creates stand-alone applications that don’t require the 
Dylan environment. 

Perhaps best of all, Dylan is not Macintosh-specific, it is 
intended to be a multi-platform language. In addition to 
Apple’s efforts, Carnegie Mellon University is implementing a 
UNIX™ version of Dylan and Harlequin Ltd. is implementing a 
Windows version. There are also freeware implementations 
available now, including Marlais, an interpreter that has been 
ported to Macintosh, Windows, and UNIX, and Mindy, a byte- 
code compiler available for the Mac (PPC and 68K) and UNIX. 


LANGUAGE OVERVIEW 

some time ago, I spent a weekend playing with Macintosh 
Common Lisp. Its peculiar notational style, e.g., using (+ 2 
3) to add two numbers, left my head reeling. When I first 
heard of Dylan, its Lisp roots conjured up images of this same 
“backwards” notation. Not to worry — Dylan uses algebraic 
notation that C and Pascal programmers will find familiar in 
many ways. Here’s a quick look to give you a feel for its 
syntactic personality. 

Identifiers for variable names, function names, etc., are 
case-insensitive and composed of alpha, numeric and a wide 
range of special characters. Some of the allowable special 
characters are the & |, <, >, /, *, +, and - symbols. In fact, by 
convention, Dylan class names are held inside a <> pair, 
Witness its <integer> class. Since some of these symbols can 
denote arithmetic operations they must be surrounded by 
whitespace — 2+3 is a valid identifier; 2 + 3 is 5. 

As you would expect, Dylan defines an assortment of 
conditional and iteration clauses, some with pleasant additional 
or new features. 

For instance, a for loop can contain more than one 
termination condition statement, and allows you to define the 
bounds check using to, above or below. Here is a 
contrived example: 


C For Loop Dylan For loop 
for (i = 0; for (i from 0 below Smax, 
i < kMax - 1: while is-it-ok?(i)) 


++i) finally do-post-loop-stuff() 
err = IsItOK(i); end for; 


if (err == false) 
DoPostLoopStuff () ; 


The use of below sets up i to count from 0 to some 
constant value, Smax - 1. By default the loop’s step value is 
1, but you can specify it by appending by n, where n is the 
increment value, to the for statement. The while clause 
evaluates the result of the is-it-ok? method, and lets the 
loop continue if it is. is-it-ok?() (which isn’t defined 
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here) returns an true / false indicator as its result. If the loop 
completes without an error, the wrapup routine, do-post- 
loop-stuff (), is called. 

There is a lot of Dylan-ese in this example. Note how 
constants, by convention, begin with the $ character. The for 
block must be explicitly terminated with an end statement. 
This goes for the other conditional statements as well: 
if/else, unless, case, and select. 

Another convention is that predicate functions, those that 
return a true / false value as is-it-ok? does, end in a question 
mark. Dylan, unlike C, defines a true Boolean class. A single 
object, #£, is considered false. All other values are considered 
true. The value #ft is provided by the language for clarity. 

Finally, notice how multi-word identifiers are, by 
convention, separated by hyphens, rather than the Inside 
Macintosh convention of capitalizing each word in the identifier. 


Namespaces 

As you've seen, it’s easy to “read” Dylan. Its syntax is 
really not that different from C++ or Object Pascal. One 
characteristic it does differ in is how namespaces are 
established and controlled. 

In C++, a class definition establishes a namespace 
encompassing both data members and methods. Access to 
class data and functions depends on their public, private and 
protected nature as established by the class designer. 

In Dylan, a module acts as a namespace. A module 
“holds” class and method definitions you choose to group 
together. Since Dylan is completely object-oriented, classes, 
methods, and data are all stored in variables. You control 
access to a module variable by choosing whether to “export” it. 
Only variables you specifically export are visible outside of that 
module. If you don’t export a variable, it is visible only within 
that module. This is analogous to C++’s public and private 
access control mechanisms. 


Class Definition 

Another difference between Dylan and C++ is in the role 
classes play. A C++ class defines member functions which give 
the class its behavior, and data members which provides 
context. In a Dylan class only data is defined. 
C++ Class Definition 


class CEvent : public CObject 
{ 


private: 
short eventType; 
short eventPriority; 
public: 


CEvent (short type, short priority = kEventPriorityNormal) 
: eventType(type), eventPriority(priority) {}; 

OSErr DoEvent(); 

I 


This mythical CEvent class defines two data members: 
eventType, whose value is the type of event, and 
eventPriority, which indicates the priority of the event. Its 
constructor requires two arguments with which it initializes the 
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1 
Which Macintosh copy protection key is committed to uncompromising technological superiority 


2 


Which key is the best selling Macintosh key in the world e 


3 


Which key was developed by Mac developers, and is the first and only 100% ADB savvy key e 


4 


Which key offers you the most sophisticated network protection available anywhere e 


5 


Which key delivers developer support response within 24 hours e 





6 


Which key has now surpassed its own technological lead, actually improving on the best e 


THERE IS ONE ANSWER ... 


MICRGGUARD 





(actual size rendering) 


For more information and to order a Developer's Kit or to receive a free CD ROM about 
MicroGuard, please contact us at: 

MicroGuard USA: Tel: (303) 320-1628 — * Fax: (303) 320-1590 ® AppleLink: M.GUARD : 
International: Tel: (972-3) 558-2345 © Fax: (972-3) 558-2344 © AppleLink: MICROGUARD Mac OS 








_ "Technology at its peak" is our commitment to you, and that is why we have actually improved the best key available and brought you 


MicroGuard Plus™ which is 100% backwards compatible with MicroGuard, just as we promised it would be. 


2. We estimate that 70% of the Mac keys sold are MicroGuard keys. 


_ We have been developing Mac applications as a seed development house since 1984. We are not a PC company that has come to you 


with a Mac product. Back when other keys clashed, MicroGuard was fully ADB savvy and offered extended addressing. Only 
MicroGuard offers this level of sophistication. 


. Our network protection, MicroGuard Net™, is so superior, we had to hire an Apple network engineer to execute our specifications. 
. We guarantee 24-hour response to your inquiries. But we don't get many, anyway. We have a fully loaded bulletin board on AppleLink 


under Third Parties that contains all our libraries, tech notes, Q&A and nearly everything you'll ever need, 24 hours a day! 


. MicroGuard Plus is everything MicroGuard is, plus 40-bit encription, four passwords, a 45% size reduction, 64-Bit Array, 32-byte public 


area, enhanced counter and more. Plus two new utilities, QuickGuard™ and EasyGuard™, which allow you to MicroGuard protect 
your applications in minutes without touching your source code. The only feature that is not plus is the price. :-) 





Fast remote internetworking 
in a single box. 





» Shared Access to the Internet 


Your whole department or organization can connect to 
; the Internet—full time or just when you need to. 
> E-mail 
Streamline communications 
with enterprise-wide E-mail. 






( __THE INTERNET 





ExpressRouter 
w/ Frame Relay 


> Telecommuting ae 
High speed access to 
the entire office network. 







> Centralized Databases 
Access or update information 
from any point on your Wide Area 
Network. 









ExpressRouter DDS 





i 


ExpressRouters 


ExpressRouter-ISDN with Integrated 
Interfaces 
> Videoconferencing 
Close the gap between a Fast File Transfer 
distant sites with LAN-to-LAN Transfer files at speeds up to 
videoconferencing. 1.544Mbps—10 MB per minute. 


What makes the ExpressRouter the best choice for your Wide Area Network (WAN) needs? 
¢ Built-in WAN interfaces for Frame Relay , ISDN, T1, and 56Kbps DDS. 
e Expandable architecture that supports up to 3 high-speed WAN ports. 
e Built-in support for AppleTalk, TCP/IP and Novell IPX LAN protocols. 
e Interoperability via PPP. 
e Support for SNMP and Telnet management standards. 
e Powerful, easy-to-use auto-dialer software designed for the Macintosh. 


9053 Soquel Drive « Aptos, CA e 95003 
Tel: 408.688.1021 ¢ Fax: 408.688.1421 ¢ E-mail: sales@engage.com *WWW: www.engage.com 


( | Engage Communication, Inc. 
AC 





two data members. The eventPriority argument is 
optional, defaulting to a “normal” priority value. CEvent also 
defines a DoEvent () method that processes the event. 

Dylan Class Definition 

define class <event> (<object>) 


slot event-type :: <integer>, 
required-init-keyword: event-type:; 


slot event-priority, 
init-keyword: event-priority:, 
init-value: Sevent-priority-normal; 
end class; 


Here’s a line-by-line breakdown of the Dylan class 
definition: 


define class <event> (<object>) 


defines a variable named <event> for the class whose parent 
class is <object>, the common ancestor of all Dylan classes. 
(As you would expect, Dylan supports multiple inheritance. 
Additional superclasses would be included, comma-separated, 
inside the parenthesis.) 


slot event-type :: <integer>, 
required-init-keyword: event-type:; 


defines a slot (akin to a C++ class data member) named 
event-type whose data type is limited to integer values. 
When an <event> object is instantiated, you are required to 
supply an initial value for this slot using the event-type: 
keyword. 
slot event-priority, 

init-keyword: event-priority:, 

init-value: Sevent-priority-normal; 
defines a untyped slot named event-priority whose 
keyword initializer is optional. If you don’t provide it, the 
slot will default to the value of the Sevent-priority- 
normal constant. 

As is typical of Dylan block end statements, end class; 
could have been written just end;,or end class <event>;. 

Note that some of the idioms so often implemented for a 
C++ class — a constructor to initialize the object’s state, a copy 
constructor to properly clone the object, and an operator= 
overload to handle a new value assignment — are not needed. 
As shown above, keywords define the slot initialization that 
takes place when the object is instantiated. Dylan has built-in 
functions for copying and assigning objects. Destructors aren't 
required either as automatic memory collection deletes objects 
that are no longer being referenced. 


Data Type Declaration 

But what’s with this unspecified data type for the event - 
priority slot? In Dylan, type declarations are optional. 
From a C++ perspective this lackadaisical approach to data 
typing seems fraught with peril. After all, isn’t the strict typing 
requirements of C++ one of its strengths? 
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If you write let a-number = 1; (let simply creates a 
local variable, see Creating and Initializing Variables below) 
you can trust the compiler to do the right thing. However 
there’s nothing preventing you from later setting a-number to 
a non-integer value, whether you mean to or not. Dylan allows 
you to provide data type information when type safety is truly 
important. In the example above, all it takes to specifically 
type a-number as referencing only integer values is to write 
the statement as let a-number <integer> = 1; 

Dylan-ites cite this characteristic of the language as an aid 
in rapid prototyping. This reduction in the cognitive load, 
however slight, has other virtues. It is pleasant to not have 
worry about whether a loop counter variable should be a long 
or a short — what does it matter? If you leave a-number 
untyped, the compiler will take care of promoting it to a larger 
data type should you ever exceed its capacity. And as 
illustrated, providing the information necessary to strictly type a 
variable is easily done. However, be careful that this new 
found freedom doesn’t go to your head. Here’s an example: 


define variable any-thing = 1; 
// any-thing is untyped, initially references an integer value 


define variable a-number :: <integer> = 1; 
// a-number is restricted to integer values 
f 
note: define variable... creates a module variable which is globally visible within the 
module. See Creating and Initializing Variables below. 
*/ 
define method foo () 
vr 
note: define method foo( defines a function named foo which takes no arguments. 


See Generic Functions and Specialized Methods below. 
* 
i 

any-thing := "a string"; 


// OK, any-thing used to reference an integer, now it references a string 


a-number := -1000; 
// OK, still references an integer value 


a-number := ‘n’; 
// compiler will complain about type violation since ‘n’ is a character constant, 
// not an integer 
end method foo; 


define method bar() 
a-number := any-thing; 
// compiler will let this pass 
end method bar; 


Since any-thing is untyped, it can contain... well 
anything. By the time you call the bar() method, any- 
thing may have been altered to reference an integer value, so 
the compiler dares not complain. Note that the error in the 
example above is not ignored, it will be caught at run-time. 
Fortunately, Dylan’s exception handling capabilities enable you 
to gracefully recover from such an error. 


Instantiating an Object 

As mentioned above, Dylan doesn’t expect you to provide 
an explicit constructor method to initialize an object. You 
create an object instance via the make method. 
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let the-event :: “event? = make (<event>, event-type: Ssome-event) ; 


defines a local variable named the-event of type <event?, 
and creates an instance of the <event> class, initializing its 
event-type slot with the value of the Ssome-event 
constant. Since we didn’t provide the event-priority 
keyword, the event - priority slot is initialized to its defined 
default value. The reference to the created instance is assigned 
to the the-event variable. 

There are a number of other slot options you can utilize in 
your class definitions. For instance, instead of an explicit 
default value, you could instead specify an init-function: 
that is called during object creation to supply the initial value 
for the slot. 

You can also specify how storage for a slot is allocated. 
By default, each object instance gets it own storage for a slot. 
You can define that a single storage location be used for a slot 
by a class instance and all its descendants (analogous to a C++ 
static data member). Dylan also supports the notion of virtual 
allocation for a slot. Storage is not automatically allocated for 
virtual slots, it is up to you to provide getter and setter 
methods that retrieve and store the value of the slot. 


Slot Accessors 

Programmatically, you always access a slot’s value via a 
function call. By default, the getter function name is the same 
as the slot’s name, and the setter function is the getter’s name 
appended with “-setter’. Continuing with our <event> class 
example above, to retrieve the slot’s value you would call: 


event-type(the-event) ; 


and to set the event type you would call: 


event-type-setter(Ssome-event, the-event) ; 


Dylan kindly provides some syntactic sugar in this regard. 
It also allows the more conventional ‘object.slot’ syntax. The 
following forms are equivalent: 


Getters 
event -type(the-event) 
the-event.event-type 


Setters 
event-type-setter(Ssome-event, the-event); 
the-event.event-type := Ssome-event; 
event-type(the-event) := Ssome-event; 


The use of the assignment operator := in the alternate setter is 
discussed in Creating and Initializing Variables below. 

In addition to the slot options mentioned in the discussion 
above on class declarations, you can also specify the names for 
the slot’s getter and setter accessor functions. You may also 
protect a slot’s value from modification (i.e. make it read-only.) 


Generic Functions and Specialized Methods 
OK — we've defined an <event> class, we know how to 
instantiate one, and by default Dylan provided getter and 
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setter functions for its slots. Big deal! — we didn’t define any 
class member functions. So how in the world do we use the 
bloody thing? 

In Dylan, the term generic function refers a family of 
methods that share the same name and basic arguments. A 
specialized method is a member of a generic function family 
whose arguments are specialized to act upon a particular object 
or object type. When you call a generic function, Dylan looks 
at all the arguments you provide to determine the most specific 
method to call. 

To explore how this form of polymorphic method dispatch 
works, we need to first refine our design. Let’s add a subclass 
of <event> specifically for window events, and another for 
mouse events. 
define class <window-event> (<event>) 

slot window :: “window, 
init-value: Snil-window, 


init-keyword: window: ; 
end class; 


define class <mouse-event> (<event>) 
slot local-coordinates, init-value: #f;: 
end class; 


(Note that the <window> class is for illustrative purposes 
only, it is obviously not intrinsic to the language. However, the 
Apple Dylan application framework does contain a window 
class and many other Macintosh-related classes.) 


Now let’s provide specialized methods to handle these 
events: 


define method do-event (event :: <event>) 


// basic event handling 
end method; 


define method do-event(event :: “window-event>) 


// window-specific event handling 
end method; 


define method do-event(event :: “mouse-event>) 


// mouse-specific event handling 
end method; 


When your event detection code calls the do-event generic 
function, the specific method that gets run depends on the 
event subclass of the object passed as the parameter. For 
instance, in response to a mouse event, you would instantiate a 
<mouse-event> object and pass it as the argument to do-event. 
All members of the do-event family are examined to see which 
method most closely resembles the objects passed as 
arguments. In this example the do-event(event :: <mouse- 
event>) specialized method is invoked. In many cases the 
compiler will be able to make this analysis and generate code 
that directly calls the most specific method thus incurring no 
runtime penalty. 

Methods pass control to the next most specialized method 
by calling next-method(), which is similar to calling Inherited 
in Object Pascal, or invoking the direct superclass method via 
CSuperclass:MethodQ in C++. For example, the do- 
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event (event <mouse-event>) specialized method may 
need to run the event handling code contained in the base do - 
event (event <event>) method before its code is run. 

In contrast, C++’s polymorphic method dispatch 
depends on common ancestry. Every class that needs to 
handle an event must (in our example) descend from 
CEvent, and with each new event that is added, the class 
hierarchy must be altered. In Dylan, you just define the 
new class and add a method specialized on the new event 
type. Dylan’s approach reduces class coupling and 
minimizes the impact on existing code when new 
functionality is introduced. If nothing else, it “feels” more 
natural. Instead of thinking “event-class, handle the mouse 
event”, it’s just, “handle the mouse event.” I know this 
difference seems trivial, but to me it is the critical difference 
between C++ and Dylan. 

Finally, note that methods, like classes, are first-class 
objects. That means they can be assigned to a variable and 
passed around like any other variable. Yah, weird... Local 
Methods below gives an example of how powerfully weird this 
feature can be. 


Method Parameter Lists 
In addition to required parameters, a method’s parameter 
list can be defined to accept an unlimited number of arguments. 


define method plot-points(#rest points-to-plot); 


defines a method named plot-points that accepts a variable 
number of arguments. Parsing the point arguments inside the 


method is easily done via: 
for (a-point in points-to-plot) //plot each point provided 
draw-point(a-point) ; 


end for; 
end method plot-points; 


To call this method, you merely pass all the points you want: 
plot-points(point-a, point-b, point-c); 

Method parameter lists can also define optional keyworded 
parameters. For instance, 
define method make-window (dimensions, #key title = "Untitled", 


has-zoom-box?) 


defines a method that has one required argument, 
dimensions, and two optional keyword arguments. If the 
title keyword is not specified, its value is “Untitled”. If 
has-zoom-box? is not specified its value is false (#f). You 
can specify keywords in any order, as shown below: 


make-window(window-size, has-zoom-box?: #t, title: "New Window"); 


Return Values 


OK, here’s a quiz. What does this method return? 


48 APPLE DYLAN 





define method square-of(x :: <integer>) 


x * xX: 
end method; 


Not real obvious, is it? In Dylan there is no explicit return 
statement — the result of a function is whatever value is 
generated by the last expression in the method, in this case x 
* x. If you were just browsing through the method definitions 
in a module, it wouldn’t be immediately apparent that this 
method returned anything at all. Luckily, Dylan allows you the 
option of declaring the result type of a method : 


<integer>) 
<integer>; //=> result value 


define method square-of (x :: 
=) x-squared :: 


x x5 


end ee eet 


The inclusion of => x-squared <integer>; reveals that 
the method returns an integer value. Note that just => x- 
squared; is legal as well. Unfortunately this is pretty much 
useless, other than as an indication that the method returns a 
result of some undetermined data type. Note as well that the 
name of the result value, x- squared in this example, never 
comes into scope. So it can be any valid identifier: the - result, 
x*x, square-of, <integer>, or omitted altogether. I’ve made 
a habit of always explicitly defining a method’s result values, and 
giving them meaningful names. Just because Dylan will let us be. 
lazy is no reason to do so. 

One feature of Dylan I have grown fond of is the ability of 
an expression to return multiple values using the values 
function. For example, let’s pretend we have a C++ method 
that accepts a Rect, and returns its height and width. In C++ 
you would declare: 
void RectSize(Rect& rect, short& height, short& width) 
| height = a-rect.bottom - a-rect.top; 


width = a-rect.right - a-rect.left; 
} 


and call it by: 


RectSize(rect, h, w); 


In Dylan you could instead: 


define method rect-size(a-rect) 
=> (height :: <integer>, width :: 
values(a-rect.bottom - a-rect.top, 
a-rect.right - a-rect.left); 
end method; 


<integer>) ; 


let (h, w) = rect-size(a-rect); 


Note that like the <point> class shown above, <rect> is not 
an intrinsic Dylan class, but it is a part of the Apple Dylan 
application framework. 


Local Methods 


Quite frankly, there’s very little I miss about my Object 
Pascal programming days, except local procedures and the 
availability of class meta-data. For those of you untainted by 
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Pascal, local procedures are small, special purpose procedures 
that can be embeded inside another procedure. They’re neat, 
clean and don’t clutter up your interface. Dylan’s got ‘em too. 
The special form local is used to bind a variable (and hence 
methods) within the current scope. Here’s an example: 


define method plot-random-point() => () //returns nothing 
local 
method compute-random(max-value) 
=> random-value :: 
let r = remainder(Random(), max-value); 
// remainder is a built-in Dylan function 
// Random is the Mac Toolbox trap 


<integer>; 


if (¢ < 0) 

ae // => compute-random returns (- r) 
else 

r // => compute-random returns r 
end if; 


end method compute-random; 


let (h, w) = screen-dimensions() ; 
// screen-dimensions returns screen height and width 


draw- point (make(<point>, 
h: compute-random(h), 
v: compute-random(w) )); 


end method plot-random- point; 


A local method’s scope is that of its enclosing method, it has 
access to the parameter list, and any other methods created 
within the local block. However, you can use a local method 
outside of this scope. For instance, if you were doing some sort 
of analysis where the function to be performed depends 
entirely on the object under scrutiny, you could define a 
method that looks at the object and returns the proper function: 


define method analyze-me(patient) => analyst :: <method>; 
// <method> is a built-in class 


local method freudian () ... end; 
local method jungian () ... end; 


if (blames-mother (patient) ) 
freudian // returns the freudian method, does not execute it 
else 


jungian // returns the jungian method, does not execute it 
end if; 
end analyze-me; 


let axe-dude = analyze-me(alan-bates) ; 
// this creates and returns a function 


axe-dude(); 
// this invokes the local method in its original scope (patient = alan-bates) 


Creating and Initializing Variables 


Like Bob’s Country Bunker where they have two kinds of 
music: country AND western, Dylan supports two kinds of 
variables: module and lexical. 

Module variables can be referenced from anywhere inside 
the module, i.e. they are “global.” A module variable is 
created using: 


define variable *current-temperature* = 55; 


// the high today in Seattle... 


You can, as noted above, associated a data type with the 
variable name, and by convention, variables whose value will 
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The C-Index/II datasheet 
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800/234-0141 from any 
phone and request docu- 
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Partial Function List 
High Level 


dbcreate dadd dfind 
dbopen dupdate dseq 
mclose ddelete dread 


Low Level and Multi-User 


cdupadd imgopen’- msetlock 
cunqadd imageback mtstlock 
cchange imagerest mclrlock 
cdelete imgclose msetsema 
Cfind bcheck mtstsema 
Cfirst bbuild mclrsema 
clast addroot _ strtwrit 
cnext droproot endwrit 
cprev cflush cispeedon 
cnextrep cibufnum _ cispeedoff 
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change begin and end with asterisks. 
Module constants (read-only variables) are defined in 
similar style: 


define constant Sthe-meaning-of-Life = 42; 


Variable names for constants, by convention, begin with a $ 
character. 


A lexical, or local, variable is created using: 


let counter = 0; 


let binds a new name to an existing object. This is unlike 
assignment, which alters the contents of an existing storage 
location. 

Like C, a local variable’s scope is limited to the smallest 
enclosing block in which it occurs. For instance, outside of this 
if block: 
define method how-loud? (album) => level :: 


if (album = "Smell the Glove") 
let volume = 11 


<integer); 


else 
let volume = 10 
end if; 
volume; //=>how-loud? result 
end method; 


volume doesn’t exist and so the compiler won’t be able to 
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make sense of the last line. volume was created by a let 
statement inside the if block, and fell out of scope when it was 
exited. What you want to do is: 





define method how-loud? (album) => level 
let volume = 
if (album = "Smell the Glove") 
11 //=> result of 'if' assigned to volume 


>: Cinteger>; 


else 
10 //=> alternate result 
end if; 
volume; //=> method result 
end method; 


But a true Dylan-Weenie would drop the references to volume 
altogether and return the result of the if statement: 


define method how-loud? (album) => level :: 
if (album = "Smell the Glove") 
11 //=> result 
else 
10 //=> result 
end if; 
end method; 


<integer>; 


Assigning Values to Variables 

I'd like to tidy up a few loose ends regarding assignment 
and equality which illustrate some important Dylan precepts. 
The special form := was introduced earlier. Unlike C, which 
uses the = to assign a value, Dylan uses := to assign a different 
value to an extant variable. 
define variable counter = 10; 


define variable delta = 20; 
counter := counter + delta; // counter now set to 30 


:= can also be used as an alternate form for setter 
functions. Recalling our Slot Accessors discussion above, 


event-type-setter(Ssome-event, the-event); 


can also be written: 


the-event.event-type := Ssome-event; 


It’s important to note that assigning the contents of one 
variable to another does not copy the object being referred to. 


let the-joker.enemy 


= batman; 
let the-penguin.enemy = 


the-joker.enemy; 


the-penguin.enemy slot doesn’t reference a copy of the 
batman object, it references the very same object as does 
the-joker.enemy slot. If you alter batman, mutating it into 
his alter ego, then both the- joker and the- penguin “see” 
the change. 


Equality Testing 

The = function is used as an equivalence test, and == is 
used to test for uniqueness. To explore the difference, let me 
present <vector>, one of Dylan’s many built-in collection 
classes. Vectors are simply one-dimensional arrays. 
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let vector-A = vector(l, 2, 3); 
// creates a vector of 3 elements: 1, 2 and 3 


let vector-B = vector(1, 2, 3); 
// creates another vector which does not share storage with the first 


(vector-A = vector-B); 
// => true. the two vectors are equivalent - their contents “appear” the same 


(vector-A == vector-B); 
// => false! the two vectors are separate objects, and so are unique 


let vector-C = vector-A; 
// now the first vector is known by two names: 
// vector-A and vector-C 


(vector-A = vector-C); 
// => true. the two vectors are equivalent 


(vector-A == vector-C); 
// => true! vector-A and vector-C reference the same object 


Built-in Collection Classes 


The last characteristic of the language I’d like to introduce 
you to is its collection classes. As in Smalltalk and Lisp, 
collection classes are an natural part of the Dylan language, not 
a feature of some external class library built with Dylan. This 
topic is so broad that it would require a separate article to do it 
justice. But I would like to touch on it briefly. 

Dylan’s collection classes include those optimized for 
dealing with arrays, byte string, unicode strings, single and 
doubly-linked lists, and hash tables. 

All of these classes support a consistent suite of functions that 
enable you manipulate and interrogate their contents. Included 
among these are functions that determine whether then collection 
is empty, the number of elements in the collection if it is not 
empty, and can perform complex “search for this set of elements 
and do this to them” operations. You've already seen an example 
of this above in the parameter list discussion. The plot- points 
method used the for construct to step through each point in the 
list provided by the caller. Note the simplicity of this for 
(each-element in the-list) do this construct - 
there’s no i = 0 counter setup, or i < range checks. 


APPLE DYLAN DEVELOPMENT ENVIRONMENT 
Since Apple’s integrated development environment (IDE) is, as 
of this writing, in an early alpha stage, specific details would be 
premature. But here’s a teaser of what you can expect. 

Source code is held in a project database, not individual 
files. You view, edit and compile your project using intelligent 
“browser” windows. A great feature of these browser windows, 
or binders as Apple calls them, is that they support multiple 
views of a project’s content. Completely configurable, you can 
split a binder window into multiple panes and set each pane to 
display a different aspect of your project and its source code. 
These panes can be “linked” together so that a change in 
selection in one pane automatically updates the display in 
another, or you can drag an item from one pane to another to 
see the different aspect of the item. Dylan comes with several 
handy binder configurations, and you can create your own and 
save them for recall later. 
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Application Builder 
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Figure 1 below shows one possible configuration. This 
binder window is displaying the Online-Insultant sample 
project, included with the current alpha release. The upper 
left hand pane displays the project-level contents: modules, 
resource and text files. Clicking on an item in the upper left 
panel causes the contents of the selected item to be displayed 
in the lower-left pane. As we see in Figure 1, the project's 
Online-Insultant module has been selected. The source folders 
contained within it - Engine, Picture, Sound, and Application — 
are displayed in the lower left pane. This browser has been 
configured to display in the right pane the source records 
contained in a selected source folder. Selecting the Engine 
source folder causes all of its source records to be displayed in 
the right pane. The Finder-like turn down arrows operate as 
you expect, expanding and collapsing the view of the selected 
item. Opening a source record in the right pane enables you 
to edit its contents. Menu commands are used to add and 
delete items in a pane. 
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Figure 1. “Project” Browser 


The modules displayed in the upper left pane directly 
correspond to the modules that define your project’s 
namespace as discussed above. The source records displayed 
in the right pane each contain one top level expression, such as 
a method, variable or a constant definition. However, the 
source folders displayed in the lower left pane have no 
corresponding language construct, they are merely an 
abstraction employed within a binder to enable you to logically 
organize your source records. 

Figure 2 shows a binder window configured to display a 
class hierarchy graph in the upper pane, the selected class’ slots 
in the lower left, and its direct (i.e. non-inherited) methods in 
the lower right. 
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Figure 2. “Class Info” Browser 


Typically you would invoke this binder window by 
selecting the class name you want more information on (e.g., by 
double-clicking on <sequence> in the text of a source record 
displayed in a project browser), and then selecting the “Class 
Info” browser from the IDE’s menu of available browsers. 

The application under development runs in a memory 
partition separate from the browser. After compilation, it is 
downloaded into the “application nub” where it executes. You 
can disconnect from your application, and reconnect to it at a 
later time, even across a network. 

The third component of the IDE is a “Listener” window. It 
looks like a MPW Worksheet window, but is much more. You 
can type Dylan functions directly into the Listener window, and 
execute them to see how they will react. The code you enter is 
downloaded to the application nub where it is executed. This 
has turned out to be quite useful, I often experiment with code 
using the Listener and once I get it working, only then do I add 
it to the actual project. You can also use the Listener to 
communicate with your running application. For instance, you 
can invoke methods within your application and have their 
result returned directly to the Listener, another handy feature 
for debugging. You can even call Macintosh OS Toolbox Traps 
from the Listener. 

The Apple Dylan application framework will feel 
immediately familiar to those acquainted with MacApp. It 
employs similar logical constructs like views, behaviors, 
commands and adorners, however it is definitely not a port of 
MacApp to Dylan. 

Apple Dylan’s cross-language support is a significant 
feature. This extension to the language, which Apple hopes will 
be adopted by other Dylan implementations, allows you access 
to the Macintosh Toolbox or C / C-compatible libraries, 
including C++, Pascal, assembler, and FORTRAN. C header files 
can be imported directly, enabling you to access the functions 
and data structures definitions as if they were Dylan objects. 
Apple Shared Library Manager and Code Fragment Manager 
shared libraries, inline traps, code resources, and PowerPC 
transition vectors are also supported. Calls between Dylan and 
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C-compatible libraries can be made in either direction. You can 
also gain access to low-level machine pointers. 


SUMMARY 
Dylan’s many qualities make it attractive. Its clean syntax offers 
little resistance to the novice, less so, I think, than C presents. 
A good C++ or Object Pascal programmer will have little 
difficulty grasping its basic constructs, though exploiting its 
more dynamic elements will take time and study. To me, its 
strongest qualities are its flavor of polymorphic method 
dispatch and automatic memory management. Prior to working 
with Dylan, I didn’t notice how much time I spent in design 
worrying about issues of class coupling and memory 
management. It’s remarkable how often I now find myself 
faced with a design conundrum in C++ that simply wouldn't be 
an issue in Dylan. Neither do I miss worrying about bogus 
pointers or memory leaks one bit. Incremental compilation, 
coupled with the ability to suspend a running program, make a 
change to the source, recompile, and step back in where you 
left off, makes the debugging cycle much less tedious. 
Take a look at Dylan — you might be surprised. 


SUGGESTED READING 
If you're like me, steeped in static languages, but unacquainted 
with dynamic languages, do yourself a favor and skim a book 
on Lisp before diving into Dylan. Trust me, it will help flatten 
the learning curve. Here are a couple I found useful: 

Freidman, Daniel P. and Felleisen, Matthias. “The Little 
LISPer”, The MIT Press, ISBN 0-262-56038. 

Koschmann, Timothy. “The Common Lisp Companion’, 
John Wiley & Sons, ISBN 0-471-50308-8. 

For Dylan-specific information, download a copy of the 
language reference manual from the Apple Dylan ftp site. You 
can also take a look at these articles: 

Matejic, Larisa. “Writing an Application in Dylan”, MacTech 
Magazine, September 1994. 

Strassmann, Steve. “A First Look at Dylan: Classes, 
Functions and Modules”, develop, March 1995. 


CREDITS 
I gratefully acknowledge the assistance of those who reviewed 
this article: Rick Fleischman, Dylan Product Manager, Apple 
Computer, Inc., and especially Steve Strassmann, Intellectrician, 
Apple Computer Inc., (aka The Dylan Answer Guy) who 
serves with great patience as mentor to us early explorers of 
Apple Dylan. 


WHERE TO GET MORE INFORMATION 
Sources for Dylan software, language reference manual and 
other documentation include: 


e Internet: http://www.cambridge.apple.com- 


Apple Dylan World Wide Web server 
ftp.cambridge.apple.com:/pub/dylan — Apple 
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Object Notification Classes 
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Serious C++ Architects 


Take control of your C++ development with S-CASE, a powerful design environment 
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e Rapid prototyping 
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* Iterative C++ code generation 
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Dylan ftp site 

comp.lang.dylan — Newsgroup discussion. 

If you'd like to join the newsgroup discussion, send your 
request to: 
info-dylan-request@cambridge.apple.com. 


¢ AppleLink: Developer Support: Developer Services: 
Development Platforms: Dylan Related 


e eWorld: go to “dev service”; where you'll find ToolChest: 
Development Platforms: Dylan Related 


¢ CompuServe: Apple support forum (GO APPLE) 
Programmers / Developers Library #15 


Want to get in on the ground floor? Apple invites beta 
testers. Send a message, including your name, address, FAX 
and voice telephone numbers, and a brief statement of what 
you'd like to do with Apple Dylan, to AppleLink: DYLAN, or to 
dylan@applelink.apple.com. 
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Publisher’s Page continued from page 6 


Over the past several years, a couple of things have 
happened. First, the Macintosh has a lot more technology in it 
— far more than any one editor can fully grasp (and still have 
time to sleep <g>). Second, the magazine has grown to a point 
that it’s time, once again, to revise our editorial approach. To 
that end, we’re creating an Editorial Board for the magazine. 
This board will have a long list of “Contributing Editors”. Each 
will focus on a niche in the Macintosh developer world. 

The magazine is still brought to you by all of the individuals 
that have been bringing it to you for a long while now. But 
today, we’ve got a broader and deeper array of resources to help 
educate all of us about Macintosh development. 

Who are these contributors? They are the movers and 
shakers in the industry. They are the folks who know a lot about 
certain niches within the Macintosh community. For starters, the 
new MacTech Editorial Board includes such experts as: 


Name Topic 

Steve Kiene, Mindvision Copland 

Liam Breck Databases 

Hazem Sayed, Digitool Dynamic Languages 
Jon Wiederspan Internet 


Richard Clark, General Magic MagicCap/Telescript 

Eric Gundrum Misc. Topics 

Steve Sisak Tips and Tidbits, 
Technical Editor 


and we are talking to others to cover the following areas: 


Component Technologies (e.g., OpenDoc) 

FrameWorks (e.g., PowerPlant, Sprocket, TCL, MacApp) 
Multimedia Technologies (graphics, sound, etc...) 
Newton Programming 

Performance Programming 

Product Reviews 

Scripting/HyperCard 

Visual Programming 


We’ve got several leads for these areas, and you'll see these 
slots filled soon. And remember, these are in addition to our 
regular columns... 


Getting Started by Dave Mark 
Programmer’s Challenge by Bob Boonstra 
Inside Info by Chris Espinosa 

Viewpoint 

Dialog Box 

Symantec Top 10 

Uniform Resource Locators by Jim Straus 


And, to coordinate these Contributing Editors, we’re creating 
a Managing Editor position at the magazine. This new position 
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is in addition to myself as Editor-in-Chief and Scott T Boyd as 
Editor-at-Large. As of this writing, this new position has not 
been filled — but look for announcements in issues to come. 
Interested parties should contact me at publisher@xplain.com. 

You should expect the Editorial Board for MacTech 
Magazine to change — with additions and deletions happening 
as the industry changes and people’s lives change. If you think 
there’s a topic that warrants a Contributing Editor we don’t 
already have, let us know. If you think that we should make 
changes to the Editorial Board, let us know that too. 

As our Internet presence comes online, we'll be adding a 
whole list of new addresses to contact us at MacTech — both 
individual editorial departments, and probably the entire Editorial 
Board. You'll be able to write to directly to those working on 
the magazine and let your thoughts be known. See page two of 
the magazine in future issues for these addresses. 


Our NEw DiIcs 
For those of you who don’t already know, MacTech has grown 
so much in the last few years, that we had to move to new 
offices. The contact info for our new Westlake Village office is: 


Mailing: 
PO Box 5200 
Westlake Village, CA 91359-5200 


Shipping: 
850-P Hampshire Road 
Westlake Village, CA 91361 


Voice: 805/494-9797 
Fax: 805/494-9798 


and of course, our e-mails remain the same. 


MOVING FORWARD 
As you can see, we've had a few things going on in MacTechLand™ 
— all of which are for the better. With our new corporate structure, 
our new offices, our new Editorial Board and staff, our new 
Internet presence and more — we're here for you, now more than 
ever. As just one example, the issue that you are now reading has 
the largest page count in the history of the magazine. 

The question now becomes: what would you like to see 
next? We’re just an e-mail away — so let us know. You can 
send mail directly to me at publisher@xplain.com. In the mean 
time, enjoy the web site, and the magazine. 
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By Jon Wiederspan, jonwd@tjp.washington.edu 


Make your World Wide 
Web server sing and 


dance. 





Last month I walked you through the 
basics of creating a CGI application 
(“CGI Applications and WebSTAR: Have 
some fun with your World Wide Web 
server”). The result was a framework 
that can be used to create almost any 
CGI application you can think of. If 
you’re like me, though, having a 
“framework” is terribly frustrating 
because it takes you right to the brink of 
being able to do what you want and 
then stops. This month I'll push you 
right over the edge as we plunge 
headlong into a real world application 
of CGI programming. 

Before we get into the meat of a 
new script, though, there are several 
preliminary topics to cover. I will cover 
how to use existing OSAXes to speed up 
your AppleScripts, how to get useful 
error replies, how to parse and decode 
the information that is passed to the CGI 
application, and the basics of how 
FORM elements work. Once all of that 
is covered you will be ready to tackle 
this month’s project, a CGI that allows 
people to leave comments about your 
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site (or whatever you want). Because I have already crammed 
a ton of information into this article, I will not be repeating 
anything from last month’s article. If you have not read it 
recently, you might want to give it a quick review or at least 
keep it close at hand while you read this one. 

This article is about writing CGI applications in AppleScript. 
When I refer to the “script”, I am talking about the AppleScript 
code that will be compiled to become the CGI application. 
When I refer to the “CGI application”, I am talking about the final 
product. Until the script is properly compiled and saved (see last 
month) it is not a CGI application. Just so nobody gets confused. 


GATHERING THE INGREDIENTS 

AppleScript has one great drawback and that is speed. As your 
scripts gets larger you will start measuring their running time in 
minutes instead of seconds. That is one of the prices you 
commonly have to pay for an easy language and it is fine for 
many uses. It is totally unacceptable for a CGI application, 
though. WebSTAR will only wait so long before it just gives up 
and returns an error to the user (that is determined by the 
timeout value that you set for WebSTAR). 

The answer to the speed problem is an OSAX (Open 
Scripting Architecture eXtension). OSAXes are code extensions to 
AppleScript that provide new commands. These commands can 
speed up your scripts greatly by doing in one command what 
would otherwise take many lines of AppleScript. An example 
could be an OSAX “caseConvert” that would convert all lower 
case characters to upper case in a text string. There are hundreds 
of OSAXes available on the Internet and various online services 
(see “Uniform Resource Locator” for some good sites to check). 

For this script I will be using four OSAXes: 

ScriptTools OSAX v. 1.3.1 — This is a suite of OSAXes that 
provide new commands for file management, sound 
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authoring a book with Chuck Shotton on Macintosh Web Administration. Expect to see it in November from Addison-Wesley 
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You've spent 
enough 
time in 
development. 


Don't let your 
installer keep 
you from $Oing 
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of disks needed to ship, 
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driven interface is so 
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prepare your installer. 

New version 2.0.2 
adds full PowerMac 
support, improved 
scriptability, 
and 
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localization, 
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To receive a free, 
fully-working copy of 
Stuffit InstallerMaker, 
call our licensing 
department today at 
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handling, and more. We will only be using the “File 10 
OSAX”, but I recommend installing the rest as well because 
of their usefulness. (freeware) 

Tokenize OSAX - This OSAX is part of the ACME Script 
Widgets collection. It takes in a string of text and a list of 
one or more text delimiters. The delimiters are used to 
break the text string up, then it deletes the delimiters and 
returns the intervening text chunks as list items. As an 
example, using the delimiters {“:”,“/”}, the text string 
“http: //www.uwtc.washington.edu/Computing/WW 
w/” would be returned as the list 
{http} (www.uwtc.washington. edu} {Computing} {W 
WW}. (shareware, $10) 

DecodeURL OSAX — This OSAX takes in a string of text and 
decodes it according to the guidelines in the URL 
specification. (freeware) 

DePlus OSAX — This OSAX takes in a string of text and 
replaces all occurences of the plus (+) character with a 
space. This is needed to take care of information returned 
by Mosaic or NetScape Navigator. (freeware) 


Installing OSAXes 

To install these OSAXes, put them in a folder called 
“Scripting Additions” in the “Extensions” folder in your System 
Folder. You cannot simply drag them over the System folder, as 
you can with other system extensions. AppleScript loads OSAXes 
dynamically, so it should not be necessary to restart your 
computer after adding new OSAXes. I still recommend that you 
do restart if possible, though, to reduce the chances of problems. 
Note: remember to take the OSAXes out of their folders before 
moving them to the System folder. 

All four of these OSAXes are available at 
“ftp: //ftp.first.com/pub/Mac/prog/as/”. Tokenize is 
part of an archive called “ACME Script Widgets 2.0”. It is a good 
idea to download these OSAXes and have them installed in 
your system before you read any further. That way you will 
have the documentation on hand (I don’t have room here to 
cover specific commands) and-be-ableto jump-right into the 
demonstration script. 


ERROR HANDLING 
Script Editor does a grammar and syntax check on your script 
every time you compile it (save it as an application or as a 
compiled script or click on the “Check Syntax” button). That 
doesn’t guarantee that the script will run without errors, though. 
It only means that every command you have used is known to 
AppleScript and seems to have the proper information provided 
for it. There is no way the Script Editor can know about other 
problems that might occur at runtime, such as a timeout (if the 
script takes too long to finish) or a failure to pass the proper 
information back to WebSTAR. In addition, since AppleScript 
doesn’t type variables until they are used at runtime, you could 
easily have the wrong type of information being passed to a 


MACTECHMAGAZINE ®@ AuGUST 1995 





command, such as a variable containing a list instead of text. 
Any one of these situations could result in an error in your 
CGI application. Unfortunately, the error information that you 
get back from WebSTAR and the operating system is not very 
useful. It may consist of an informative statement like “CGI 
application failed” and an error code number or you may just 
get a blank page. In addition, the error may cause your CGI 
application to post an error notification on the server (a 
blinking icon in the menubar or a dialog box) and the CGI 
won't work again until you acknowledge the notification. 
Luckily, AppleScript contains a construction for handling 
errors so they won't tie up your server. The compound 
statement looks like this: 
try 
[your code goes here] 
on error errNum number errMsg 


[error handling code goes here] 
end try 


If an error occurs in the code between the “try” and “on 
error” statements, execution will pass to the “on error” handler. 
AppleScript always includes two pieces of information for the 
handler, the description of the error (errMsg) and the error 
number (errNum). This information allows you to take 
different actions depending on the source of the error. 
Remember to keep the code in the error handler simple, since 
an error can also occur there, in which case the script will stop. 

The first thing we will do is take last month’s code and add 
the try construction. For optimum protection, the try statement 
should be the very first line inside the WWWQsdoc event handler 
and the on error handler should be the last thing. The main 
thing we want to do in the error handler is to return information 
to the user so that they will know (1) what happened and (2) 
what to do about it and so WebSTAR won't be left waiting for a 
reply. The following code will do just that. 

on error errMsg number errNum 
set return_page to http_l0_header 7 
& "<HTML><HEAD><TITLE>Error Page</TITLE></HEAD>" 7 
& "<BODY><H1>Error Encountered!</H1>" & return 7 
& "An error was encountered in this script." & return 
set return_page to return page “ 
& "<H3>Error Message</H3>" & return & errMsg & return 7 
& "<H3>Error Number</H3>" & return & errNum & return 7 
& "<H3>Date</H3>" & return & (current date) & return 
set return_page to return_page 7 
& "CHR>Please notify the webmaster at "7 
"<A HREF=\"mailto:webmaster@your.domain.name\">" 7 
& "webmaster@your.domain.name</A>" & " of this error." 7 
& "</BODY></HTML>" 


return return_page 
end try 


@ 


This code is pretty straightforward. First it builds an HTML 
text document to return and store the information in 
return_page, then it returns return_page to WebSTAR. 
Notice that the first thing added to return_page is the 
http_l10_header. I can’t say often enough how important it 
is to return a proper header for the client (you may think I can, 
but I really can’t). The HTML document tells the user what the 
error message was, the identification number of the error, and 
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when the error occurred. Then, at the bottom of the page, it 
tells the mail address to send the information to (you will want 
to change this address, of course, to the real address for the 
webmaster of your site). If the user has a mailto-capable client, 
they can mail the information right from this error page. 


Other Common Errors 

The try construction won't handle all errors, though. It 
only catches those that cause the CGI application to stop 
execution without crashing the entire server. Here are the most 
common remaining problems that you might encounter. 

1) The majority of problems are with incorrectly installed 
OSAXes. These usually result in errors when you try to 
compile or “check” the script. The first thing you should do 
when AppleScript complains about a command not found or 
an event not available is to re-install the OSAXes and restart 
your computer (the one the CGI application is running on). 

2) The DecodeURL OSAX does not process 8-bit (international 
or double-byte) text correctly. The CGI application will run 
but may return garbage or altered text instead of the 
international characters. There is a modified DecodeURL 
OSAX from Motoyuki Tanaka that correctly processes 
international text. The OSAX is available from his home 
page at “http://mtlab.ecn.fpu.ac.jp/guruguru/ 
others/DecodeURL_8bits.hqx”. 

3) It is important to remember is that all processing for this 
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FAX (919) 851-9528 


CGI ends when the information is returned to the user. A 
CGI application is launched when WebSTAR sends the 
proper Apple event to it and it ends when the reply to that 
event is sent back by a return statement. Some people 
think they can save processing time by returning 
information quickly to the user then processing the rest of 
the information. Nope. 

4) WebSTAR will not wait around forever for a reply from your 
CGI application. The amount of time it will wait (in 
seconds) is defined by the timeout value setting for the 
server. If you suspect that your CGI application will take a 
long time to process the information, remember to increase 
this setting. If WebSTAR times out, it will return the -1701 
error code, meaning that no reply was returned from the 
CGI application. 


Improved Error Reporting 

There are many ways that the error handler could be 
improved, of course. You could use the error number to 
provide a more informative error message for the user or you 
could return the contents of some key variables to show their 
intermediate values. You could also use another script (one 
that works) to automatically send a mail message to yourself 
about the error so you don’t have to count on the user doing 
so or log the information to disk. Be creative. Go wild. The 
world’s your oyster. 
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Welcome! 


I don't know why these things are so popular, but they are. Leave your pearls of wisdom 
here. 





Figure 1: A sample form page 


FORMS 


Now it is time to talk about “forms”, by which I mean HTML 
documents that contain FORM elements. Forms allow you to 
gather input from your users by providing text fields, checkboxes, 
lists, and other items which the user can manipulate. Every form 
also contains a button so users can send the information in the 
form to the server. Forms are very important because they are 
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really the only way to get extensive user interaction with your 
Web pages. The search interface is too limited for getting much 
information and maps are even more so. Figure 1 shows what a 
form page might look like. 

The selection in Text 1 shows how the form portion in 
Figure 1 looks as HTML text. This sample displays one type of 
input, the text field, but there are others such as radio buttons, 
checkboxes, scrolling lists, and popup menus. There is not 
room here to cover how to write the forms themselves, but any 
good HTML book will cover them in detail. Instead, I will 
focus on two topics, how a form page interacts with a CGI 
application (general) and how the form data is encoded before 
it is sent to a CGI application (specific). I’m assuming in the 
following sections that you are already familiar with interactions 
between a WWW client, WebSTAR, and CGI applications, as 
outlined in my last article. 





<FORM ACTION="/cgi/Guestbook.acgi" METHOD=post> 


<P>Your name:<INPUT TYPE="text" NAME="name" 7 

VALUE=""" MAXLENGTH=40> 
<BR>Your comment:<TEXTAREA NAME="comment" ROWS=4 
COLS=60></TEXTAREA><BR> 
<INPUT TYPE="submit" NAME="S" VALUE="Add to Guestbook"> 
<INPUT TYPE="reset" NAME="R" VALUE="Clear this Form"> 
</FORM> 





Text 1: Sample form section of an HTML document 
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Processing Forms 


Every form page has to have at least one SUBMIT-type 
input defined. This presents a button (for graphical browsers) 
that allows the user to send the information from the form 
fields off for processing by a CGI application. When the button 
is clicked by the user, all of the information in every field is 
packaged together into one large piece of form data to be sent 
off for processing. The very first tag in the form section defines 
where the form data will go and what method will be used to 
send it. The tag looks something like this: 


<FORM ACTION="/cgi/Guestbook.acgi" METHOD=post> 


The METHOD defines how the data in the form fields will 
be sent (in this case, using the POST method) and the ACTION 
provides a URL to the CGI application that will receive and 
process the data. In most cases, like this one, the CGI 
application will be on the same server as the form page that 
calls it, so the URL is just the path (relative to WebSTAR) and 
file name. You can also link to CGI applications on other 
servers by specifying a complete URL. That is a good way to 
distribute the processing load over several computers, or a 
good way to make someone angry, depending on whether you 
have permission to do it or not. 

This brings up a good use for last month’s example. That 
basic CGI is perfect for testing whether you are using the 
correct path to call the CGI application or not. Put it where 
you would normally put the CGI that you plan to use to 
process the form and give it the same name. Since it doesn’t 
do any special processing or use any OSAXes, it is practically 
guaranteed to work if you call it correctly. Another easy way 
to tell if you are using the correct path is to check whether 
your CGI gets launched or not. First make sure the CGI 
application is not running, then bring up the form page and 
submit some data. Now check and see if the CGI application is 
running. If it is then you used the correct path and the 
problem is somewhere else. 


Form Data Encoding 


If you look at the form in Figure 1 for a minute you should 
notice one problem: how do you pass all of that information to 
the CGI application? There are only two fields there, but 
imagine if there were a dozen or more. Well, there are lots of 
ways it could be done, but the people who wrote the CGI 
specification chose the following method: 

First, for every item in the form (meaning every field, 
checkbox, etc.) the name of the item is concatenated with the 
data in the item using an equals (=) character to delimit the 
two. Thus you have a string of text that looks like 
“name=data”. Then, each of these strings is concatenated into 
one long string using the ampersand (&) to delimit each pair. 
The final string looks like this: 


namel=datal&name2=data2&....&namen=datan 


You can see that this introduces a problem, namely what if 
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there are “=” or “&” characters in the data itself? How do you 
differentiate between those and the delimiters? The CGI 
specification solves this by specifying that any occurrences of 
these characters in the data is to be encoded as “%XX” where XX 
is the hexadecimal equivalent of the character. Using this 
method, each “=” becomes “%3D” and each “&” becomes “%26”. 
This is known as “URL Encoding” because it is also part of the 
specification for encoding special characters that might occur in a 
URL. With URL encoding there are many special characters that 
are encoded, such as_ + (%2B) <space> (%20) and % (%25). In 
addition, client software is allowed to encode other characters if 
it is deemed necessary to ensure their transmission in data. 

There is one small problem with this encoding. There are 
two big players in the Web scene who do not strictly follow 
this pattern, those being NCSA (Mosaic) and Netscape 
(Netscape Navigator). Early on, Mosaic decided to encode all 
occurences of a space as “t+” instead of “%20”. Netscape 
followed suit with their browser, presumably because much of 
the original Mosaic team was involved and tended to make the 
same decisions the second time through. Since many 
commercial browsers are based on the Mosaic (or Enhanced 
Mosaic) code, this problem is spreading. 


PROCESSING FORM DATA 
With this information, you are now ready to make use of the 
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data that users submit from your form pages. There are two 
types of information passed to a CGI application by WebSTAR. 
The first information is external, meaning that it is received from 
the WWW client as part of a form page submission, or a map 
click, or something similar. This information may be in one or 
more of the variables path_args, http_search_args, or 
post_args, depending on the method used, and should be 
URL encoded. The other information is internal and is 
generated by WebSTAR directly. This includes all of the other 
variables such as referer, script_name, and method and is 
not encoded. There is also one special variable 
full_request which contains the entire request as it was sent 
from the WWW client to WebSTAR. Some of the text in this 
variable will be URL encoded. 

Because all of the data in the external information is 
encoded, you use will need to decode the information before 
you can use it. In addition, if the data in one of the variables 
came from a form page (and I’m assuming here that it did) then 
the data must be parsed into individual fields and the field data 
separated from the field names. The following script fragment 
will do both functions: parsing and decoding. In this example, 
the script processes the information in the post_args variable, 
which is where the data would be put from a form using the 
POST method for submission. The same process works for 
http_search_args if the form uses the GET method. 
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set postarglist to tokenize (dePlus post_args) 7 
with delimiters {"&"} 


set oldDelim to AppleScript's text item delimiters 
set AppleScript's text item delimiters to {"="} 
repeat with currpostarg in postarglist 
set currname to first text item of currpostarg 
if currname = "name" then 
set messageName to (Decode URL 7 
(last text item of currpostarg)) 
else if currname = "comment" then 
set messageBody to (Decode URL 7 
(last text item of currpostarg)) 
else if currname = "S" then 
-- ignore it. That's the Submit button. 
else 
-- generate an error to report the unknown field 
error ("Unknown field in post_args: " & currname) 7 
number 100 
end if 
end repeat 
set AppleScript's text item delimiters to oldDelim 


The first line of this fragment makes use of two OSAXes to do 
the bulk of the processing. There are actually three commands on 
this line. The first “dePlus post_args” is in parentheses to 
indicate that the result of that command is to be the input for the 
surrounding command. dePlus quickly scans the entire block of 
text passed in post_args and converts all occurrences of “+” to a 
space. The second command, “tokenize () with 
delimiters {“&”}” takes the text output of dePlus and 
converts it to a list with each item representing the text between 
ampersand (&) characters. Note that the ampersands are removed 
as part of this process. The result is a list in which each element is 
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a “name=data” pair. The third command is an assignment “set 
postarglist to ” which assigns the list output from 
Tokenize to the variable postarglist. 

The rest of the script fragment processes the list one item 
at a time, looking at the name portion of the item, and then 
assigning the data portion of the item to the proper variable 
based on the name. Although you could use the Tokenize 
OSAX again to do this, I have chosen to do it with 
AppleScript’s text item delimiter instead to show you the 
alternative. Since there should be only one occurence of the 
delimiter in the item text, the speed should be about the same. 
First the script saves the current text item delimter settings (to 
be restored later), then it uses a repeat loop to look at each list 
item in turn. Each time through the loop, the script extracts the 
name (first text item of currpostarg) and uses a 
series of “if...then” statements to see what the name is. When a 
name match is found, the data (last text item of 
currpostarg) is extracted, passed to DecodeURL to convert 
all of the hexadecimal codes back to the original characters, 
then assigned to a variable for use later on in the script. 

If you want this script to handle more fields or fields with 
different names, this is the section to change. To handle more 
fields, you need to add more “elseif” statements to the script, 
one for each new field. The statement should assign the new 
field’s data to a variable or concatenate it to an existing variable 
somehow. If you want to handle different fields, you need 
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only change the text string that is used to match the field name. 
This script is set so that the default action, if the name of the 
field doesn’t match what you were expecting, is to generate an 
error message. The line that does this (error (“Unknown 
field in post_args: & currname) number 100) 
causes processing to jump to the error handler, telling it what 
the unexpected field name was. The number 100 was chosen 
at random and has no meaning here except to make sure that a 
number is passed. 

Normally, you would extract the information from the 
post_args variable by reversing exactly the procedure that 
was used to create it, meaning that you would parse the 
name=data pairs, then extract the data, and then do all of the 
decoding (including converting “+” to space). You could do 
that, but as it turns out it is safe to run DePlus on the entire 
post_args at once because the + character is not used as any 
kind of delimiter. This can save a significant amount of 
processing time on a large form. 

If you are reading information from post_args that is not 
from a form (or from http_search_args or path_args), 
you can decode the entire data with the one line “set 
<variable> to Decode URL (dePlus post_args)”. 
Note that it is necessary to do the + to space conversion before 
decoding the hexadecimal encoded characters. If you reverse 
that process you might decode some more + characters, which 
would then incorrectly be converted to spaces. 
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That is all of the preliminary information. You are now 
fully equipped for the real world example. 


A COMMENT PAGE: DIVIDE AND CONQUER 

Now you are ready for some real fun! This script will use the 
script in last month’s article as a base, add the features discussed 
above, show you even more features, and use the results to do 
something we all want: provide a page where people can leave 
nice comments about our work. In addition, this script will display 
some tricks for getting better response speed from your CGI 
applications. By response speed I mean the speed with which the 
CGI application returns data back to the user. This is the only 
speed that matters when you are writing a CGI application. 


Speed Tricks 


The first trick is to cache the page in memory. Any CGI 
that needs to read data from a disk file is going to be slowed 


down by the disk access. If you can read the data once and 
cache it into memory you can significantly speed up processing 
time. This comes at a slight price, of course, because your CGI 
will use more memory to cache the pages. Most pages are 
relatively small, though (<32K), so this shouldn’t be much of a 
problem until you try to handle dozens of pages or more. For 
this example we will read the entire page in when the CGI 
application is launched so it will be ready when the first request 
comes in. Since all of this processing makes the CGI application 
a bit slow to launch, I recommend that you set it to launch at the 
same time that WebSTAR does so it is ready for the first request. 


The second trick is to put off writing data to disk until idle 
ime. Writing information out to disk is even more time 


consuming than reading it in. Writing to the end of a file is not 
too bad because it always takes constant time. You just 
position yourself at the end of the file, then extend it with the 
new data. In a comment page, though, it is preferable to have 
the newest comments at the top so people see something new 
immediately when they visit the page. This requires that you 
insert the new text into the beginning portion of the file and 
move all of the rest of the file to make space. Doing this takes 
longer and longer as the file increases in size. 

We will get around this by keeping all of the information in 
memory and only writing it to disk when the CGI application is 
idle. It will still take longer to write the data as the file grows in 
size, but you are using “spare” time so it doesn’t matter much. 
In addition, you can save up several entries before writing to 
disk so you write much less often. Of course, this requires that 
your server be at least somewhat stable or else you lose all of 
the information cached in memory when it crashes. The more 
stable your server is, the longer you can go between writes and 
the bigger speed improvement you will see. 


ct 


File I/O OSAX 

There are several ways to read from and write to disk files 
in AppleScript, depending on what version of the operating 
system and AppleScript you are using. I won't be able to cover 
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all of these in this article, so I have chosen to use the ScriptTools 
package by Mark Aldritt. This suite of several OSAX includes 
one for file I/O called “File IO OSAX”. This OSAX provides 
commands to open and close a file, read in data, write data, get 
the size of a file, and get your current position in a file (where 
you will read from or write to next). The documentation is 
excellent, so I will leave the exact syntax to your own study. 

The File IO OSAX reads data from disk one line at a time (a 
line being all of the text up to the next carriage return). By 
default it limits a line to 1024 bytes, but that can be increased to 
the limit of the available memory. Since each line requires a disk 
access and the overhead on this is significant, you can cause the 
script to run more quickly by keeping your text file to as few 
lines as possible. HTML text gets its formatting from tags and not 
from carriage return or linefeed characters, so it does not hurt the 
presentation of the document to have all of the text on one line. 
Here is what the HTML text file I use for this script looks like: 


<HTML><HEAD><TITLE>Jon’s GuestBook</TITLE></HEAD><BODY><H1> 
Welcome!</H1>I don’t know why these things are so popular, 
but they are. Leave your pearls of wisdom here.<P><IDIf you 
want to format your comment you will need to use HTML tags. 
Please do not link to large graphics.</I><HR> 

<P><FORM ACTION="/cgi/Guestbook.acgi" METHOD=POST><BR>Your 
Name:<INPUT TYPE="text" NAME="name" VALUE="" SIZE=20 
MAXLENGTH=40><P>Your Comment:<TEXTAREA NAME="comment" 
ROWS=3 COLS=50></TEXTAREA><BRO<INPUT TYPE="Submit" 
VALUE="Add to Guestbook"><INPUT TYPE="reset" NAME="8" 
VALUE="Clear this Form"></FORM><HR> 

<!-- DIVIDE_HERE --> 

<P><B>Mike Hon</B> (rewusr.bp.com.) <I>Wednesday, May 31, 1995 
7:30:58 AM</I><BR>V.impressive. Hope to see you speak at 
WebEdge II. 

<HR><A HREF="/JonWiederspan/JonW.html">[Return to Jon’s Home 
Page] </A><BR><A HREF="/cgi/Guestbook.acgi?view"> [Reload the 
guestbook] </A></BODY></HTML> 











This is actually only four lines, as shown by the indentation. 
That means that I only have to access the disk four times to read 
everything in. I have left one user comment in to show how I 
also save each comment on a single line so the file does not 
grow too quickly. If you really want to save some accesses in a 
large file you could probably cram several comments on each 
line, but then you're talking about a seriously ugly text file. 

One line of the file is used as a marker to indicate where 
the new comments should be inserted. The marker is 
embedded in an HTML comment so it is never displayed by the 
client software. When the script reads the file into memory, it 
divides the file so that everything from the start of the file to 
and including the marker is in the top portion (header_data) 
and everything after the marker is in the bottom portion 
(footer_data). This allows new comments to easily be 
added by prepending them to the footer_data and then 
concatenating the two pieces back together to reform the file. 

The code that reads the file into memory is not in a 
handler. Instead, it is at the very beginning of the script. This 
causes it to be executed immediately upon the launch of the 
CGI application. This can be a problem with some CGI 
applications because of the way WebSTAR communicates with 
them. When WebSTAR receives a request for a CGI application 
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that is not currently running, it first tells the application to 
launch itself, then it sends the CGI request. If the CGI 
application has a lot of processing to do at launch, it will likely 
start processing the CGI request before the startup processing 
finishes (it can run both processes at the same time) which can 
result in incomplete results or even failure for the first request. 
In these cases it is especially important to make sure that the 
CGI is launched before or immediately after WebSTAR launches 
So it is ready to process any possible customer requests. 


Reading The File Into Memory 

Here is the section of code that handles reading the file 
into memory. The first line puts the name of the file on disk 
into a variable (guestFile). This variable is shared as a 
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global variable and used by all routines that read from or write 
to this file. 


set guestFile to “Macintosh HD:MacHTTP Server:Guestbook. html” 


The next step is to read the file into memory. The script 
opens the file, then reads line by line, adding each line to the 
header_data until a line is encountered that contains the 
marker (<!-- DIVIDE_HERE -->). Notice how each line 
needs to have a carriage return added because the OSAX strips 
that character out when it reads from the file. After the marker 
is found, the script reads the rest of the lines, this time adding 
them to the footer_data. Since we're not looking for a 
marker at this point the script saves a little time by adding the 
file data directly to footer_data. 
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end repeat 
-- open the file for reading 
set fileRefNum to open file (guestFile as alias) -- you're done with the disk file for now 
a close file fileRefNum 
-- initialize storage for the first part of the file 


set header_data to "" : : . . : « 

P read cer line andl thewmenker detected fe entire section of the script is wrapped in a “try...on 
repeat error” construction so that any errors that occur will go to the 
set currLineData to read file fileRefNum 

erro 
set header data to header_data & currLineData & return ‘ handler shown. The first thing the error handler does is 
if currLineData = "<!-- DIVIDE HERE -->" then close the file, since you will always want to do that so the file 
ao or is not damaged in the event that the CGI application crashes. It 
end repeat then tests to see what type of error occured. The only error the 
Jpindbedoasetortierseortieal script specifically handles is the one that indicates the end of 
set footer_data to "" the file has been reached, at which point the script processing 
sees the rest of the lines stops and waits for another event to be sent. It would be a 
set footer data to footer_data & (read file fileRefNum) 7 good idea to also test for other common errors such as a non- 
& return existent or busy file. 
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Have you ever thought about writing an article? The 
editorial staff at MacTech Magazine would like to personally 
invite you to write for the publication. While writing an 
article is not difficult, it does take a bit of time. But, you get 
to share your knowledge with the community, see your 
names “in lights”, and ... you get paid for your efforts! 

To get started, you can download the MacTech Writer's 
Kit from one our online support areas. Here you will find 
information on how to submit an article — and it comes with 
examples, templates and style sheets. Feel free to e-mail us 
with questions. 


CALL FOR ARTICLES 


Many of you have asked “what topics would we like to see?” 
Recently, our Editor, Scott T Boyd, provided us with insight as to 
what he'd like the magazine to cover in 1995. Our goal at the 
magazine is to publish articles on diverse topics that are sure to 
keep our readers both interested and well-informed throughout 
the year. If you'd like to be part of this group, think about what 
you know about — that’s what we'll be most interested in. As a 
guideline, you can think about one of the following issues. 


For example, topics that include articles that teach 
debugging techniques and advocate good debugging tools. 
This continues a recent theme about making software more 
reliable. We will continue to talk about “cool” Apple 
technology such as Threads and Drag and Drop; or as Scott 
said, “software that takes us out of the Stone Age.” 

There will be tips on how to get your business on the 
Internet and how business models are shaping up. More 
heavy-hitting deep technology articles will be included, 
such as the recent September article on emulator technology 
and the two-part article on PowerPC Architecture. We'll see 
continued coverage on the developments in OpenDoc and 
OLE technologies, as those on the sidelines start choosing 
up sides or deciding not to play. 

MacTCP is another area of importance, as more people 
get excited about providing Macintosh-quality software for 
Internet users. You will see additional coverage on Visual 
Programming. You should also expect to see more on cross 
platform development. And, even though it’s a moving 
target, we will be covering Apple’s next System Software 
release — Copland. 


E-mail us with your idea and let’s talk. You never know, you might get your name “in lights”! 


TSM TT 


Cry 
[code to read file into memory goes here] 


on error errMsg number errNum 
close file fileRefNum 
if errMsg = "End of file error." then 
-- we're all done reading data. 
-- ignore the error 
else 
return OK_header & "<TITLEDERROR! </TITLE>" 
& "CH1>Error Notice!</H1><B>Error Number:</B> " & 
errNum 7 
& "<BR<B>Error Message:</B> " & errMsg 
end if 
end try 


Adding New Comments 


The CGI event handler loop is pretty much the same as I 
described earlier. The form page has only two fields, so 
processing is very quick. The data from the name field is put 
into the commentName variable and the data from the comment 
field is put into commentBody. The main difference is that this 
handler actually does something with the variables. The 
following line adds the two variables (and the user’s IP address 
and the current date) to the existing comments at the start 
of footer_data then the next line forms the return_page 
by concatenating the HTTP header, header_data, and 
footer_data and returns the result to WebSTAR. 
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set footer_data to "<P><B>" & commentName & "</B> ("7 
& client_address & ") <I>" & (current date) & "</ID<BR>" 7 
& commentBody & return & footer_data 

set return_page to OK_header & header_data & footer_data 


Saving To Disk 


One reason this CGI application is able to respond so 
quickly to the user is that the data is not saved to disk until 
later, when there is idle time. The idle handler is run whenever 
an idle event is sent to the CGI application. Idle events are 
sent when the application itself does not receive an event or do 
any processing for a specified period of time (it doesn’t matter 
if the rest of the computer is busy). The value returned from 
the idle handler tells the system how long to wait (in seconds) 
before sending another idle event. 

When an idle event is received, the following code is run 
to save the current comments to disk. 
on idle 

global guestFile 


global header_data 
global footer_data 


set fileRefNum to open file (guestFile as alias) 
write file fileRefNum text header_data & footer data 
close file fileRefNum 
-- wait 30 minutes for the next idle event 
return 1800 

end idle 
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The same code is executed when the CGI application is 
quit by including a quit handler. That ensures that you don't 
lose any comments added since the last idle time. 


Further Improvements 

There are several ways that this script could be improved. 
Some of them were in my original script but had to be left out 
to fit in one article. For example, you could add a variable that 
tells whether any new comments have been added or not. 
That way you could run the idle handler a little more often 
and test whether information needs to be written to disk. The 
idle and quit handlers should also have “try...on 
error” contructions added in case there is a problem opening 
or writing to the file. 

This script works with a dynamic page, meaning one that 
has information added to it by the user. This method of 
reading a page into memory and user a marker to insert data 
into a page can be especially powerful when it is used with 
static pages, though, where the page does not change, so no 
information needs to be written to disk. If you want to add a 
hit counter to a page, or show the current date, or insert a nice 
hello message with the clients’s machine name, this is the way 
to do it in AppleScript. If you use a counter, of course, you 
will want to save it as a script property so you don’t have to 
restart it at zero every time the CGI application quits. 
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OTHER CooL UsEs FOR CGI APPLICATIONS 

The list of possibilities for using CGI applications with WebSTAR is 

nearly endless because you can use AppleScript to not only do 

custom processing but also to link WebSTAR with almost any other 

Macintosh application. Here’s a short list of some of the cooler 

stuff that you will find already in use on various WebSTAR sites: 

e Interface with Eudora to receive e-mail from Web pages or 
to automatically mail out files or send mail directly using the 
TCP/IP Scription OSAX. 

° Interface with applications like Butler, 4D, FileMaker, TR- 
WWW, HyperCard, and AppleSearch to make databases and 
text documents searchable via Web pages. You can also 
allow users to update database information with this interface. 

° Provide Web pages that allow you to monitor and control 
network applications like ListSsTAR, WebSTAR, and 
TribeLink’s SNMP software. 

e Control hardware to provide live pictures of remote 
locations 

¢ Make pages that change depending on the client's IP 
address or the WWW browser type. 


CLOSING 
So, now you know everything that I know. Well, not really but 
at least you know everything I know about CGI applications. 
Well, not even that actually, but you do know enough to get 
started on some really fun projects of your own. In closing 
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Is your application tak- 
ing cut & paste a little too 
literally when it creates text? 
Does your text look like it 
was created on a ten year 
old mainframe? Then you 
need PAIGE™, DataPak 
Software’s latest multi-plat- 
form text editor and page 
layout programming li- 
brary. 

PAIGE helps you pro- 
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there are three points that I want to leave you with. 

First, buy an AppleScript book. Whether you are a novice 
programmer or have ten years’ experience, you will benefit 
from one of the several fine books on the market now. This 
article is only intended to get you over the first hurdle, that of 
how to get the information from WebSTAR and put it into a 
useful form. Everything from here on out is AppleScript. 

Second, if you plan to continue using AppleScript heavily 
(and there are lots of fun things you can do with it besides CGI 
applications), I also recommend that you investigate one of the 
fine Script Editor replacements that are now available. The 
three I know of — ScriptWizard, ScriptDebugger, and Scripter - 
are all three tremendous improvements and will save you hours 
of time both in debugging and in creating new scripts. 

Third, make use of the resources that are available on the 
various networks. You can subscribe to the MacScripting 
mailing list, or just search past archives of the list, or check out 
the scripting section of your favorite online service. Any one of 
these will put you in touch with hundeds, if not thousands, of 
people who have already gone through the same problems you 
will encounter. At least one of them will probably be willing to 
help you avoid the trouble areas. Of course, people will be 
more likely to help you if you read the book first to learn about 
the most common mistakes. 

Fourth, be a source of help. If you have benefitted by this 
article, or by others who answer your questions, pass that help 
along to someone else who may be just starting out. And be 
gentle in correcting beginners’ mistakes. You never know when 
the person you help might turn out to be your future employer. 


LATE BREAKING OSAX NEWS... 
As I was finishing this article, two new OSAXes were released 
that would greatly simplify the process of extracting the 
information from forms in CGI applications. The first product is 
“Parse Post Args OSAX” by Wayne Walrath. This OSAX is a new 
addition to the ACME Script Widgets collection and is available 
free to currently registered users of the ACME Script Widgets. 
The second product is the “Parse CGI OSAX” by Document 
Directions. This OSAX is shareware ($10) and available at 
“http://marquis.tiac.net/software/home.html”. Both of these 
OSAXes perform basically the same function, combining the 
features of Tokenize, DecodeURL, and DePlus to create an easy 
and much faster interface for working with form data. They 
differ primarily in the way they hand information back to the 
user and neither is a clear ‘winner’ at this point. 


Listing 1: WriteComment.txt 





-- this is a line termination indicator 

set crlf to (ASCII character 13) & (ASCII character 10) 

-- standard header for returning file data 

set OK_header to "HTTP/1.0 200 OK" & crlf & "Server: 
WebSTAR/1.0 ID/ACGI" & crlf & "MIME-Version: 1.0" & crlf & 
"Content-type: text/html" & crlf & crlf 

-- this is the guestbook text/html file 

set guestFile to "Macintosh HD:MacHTTP Server:Guestbook.html" 
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navigation to subroutines ° FaceSpan" link « Background processing 
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~ debug properly: truly line-by-line, so you catch the offending code in the act. 
And only in Scripter can you then fix the problem, and continue debugging — 
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-- this code is run on startup to read the file into memory 
set fileRefNum to open file (guestFile as alias) 
try 
-- initialize storage for the first part of the file 
set header_data to "" 
-- read every line until the marker is detected 
repeat 
set currLineData to read file fileRefNum 
set header_data to header_data & currLineData & return 
if currLineData = "<!-- DIVIDE HERE -->" then 
exit repeat 
end if 
end repeat 
-- initialize storage for the rest of the file 
set footer_data to "" 
-- read in the rest of the lines 
repeat 
set footer_data to footer_data & (read file fileRefNum) & return 
end repeat 


-- you're done with the disk file for now 
close file fileRefNum 


on error errMsg number errNum 
-- if anything goes wrong you still want to close the file 
close file fileRefNum 
if errMsg = "End of file error." then 
-- we're all done reading data. 
-- ignore the error 
else 
return OK_header & 7 
"<TITLEDERROR! </TITLE><H1>Error Notice! </H1><B>Error 
Number:</B> " & errNum & "<BR><B>Error Message:</B> " & errMsg 
end if 
end try 


ween RAR RASA HE 2 3 2 4 1 I 9 4 fa 9 9 2 4 2 Oo 2 fo oo oo oO 


-- THIS IS THE APPLE EVENT HANDLER TO 
-- ACCEPT EVENTS FROM WEBSTAR 
en RR RAR AR AR IRA A A I He OB I Rf 2 a of I OK 
on «event WWWQsdoc» path_args 7 

given <class kfor>:http_search_args, «class post»:post_args, 
«class meth>:method, «class addr>:client_address, «class 
user>:username, «class pass»:password, «class frmu>:from_user, 
«class svnm>:server_name, «class svpt»:server_port, «class 
scnm>:script_name, «class refr>:referer, «class 
Agnt»>:user_agent, «class ctyp»:content_type 


try 
global header_data 
global footer_data 
global OK_header 


-- parse post_args into a list of name=data items 

-- and convert + to space 

set postarglist to tokenize (dePlus post_args) 7 
with delimiters {"&"} 


-- process each item to extract the data and decode it 
set oldDelim to AppleScript’s text item delimiters 
set AppleScript’s text item delimiters to {"="} 
repeat with currpostarg in postarglist 
set currname to first text item of currpostarg 
if currname = "name" then 
set commentName to (Decode URL 7 
(last text item of currpostarg)) 
else if currname = "comment" then 
set commentBody to (Decode URL 7 
(last text item of currpostarg)) 
else if currname = "S" then 
-- ignore it. That’s the Submit button. 
else 
-- generate an error to report the unknown field 
error ("Unknown field in post_args: " & currname) 7 
number 100 
end if 
end repeat 
set AppleScript’s text item delimiters to oldDelim 


-- insert the new comment at the start of the footer 
-- then build the text page to return to the client 
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set footer data to "<P><B>" & commentName & "</B> ("7 
& client _address & ") <I>" & (current date) & wc/IP<BR?” > er 
& commentBody & return & footer_data 

set return_page to OK_header & header_data & footer_data TT @ Se 

return return_page MACINTOSH SEMINARS & CONSULTING +o 


- return the text data 


on error errMsg number errNum 

set return_page to http_l0_header 7 
& "CHTML><HEAD><TITLED Error Page</TITLE></HEAD>" za Richey Software Training provides 
& "<BODY><Hl>Error Encountered!</H1>" & return 7 
& "An error was encountered in this script." & return 

set return_page to return_page 7 
& "<H3>Error Message</H3>" & return & errMsg & return 7 
& "<H3>Error Number</H3>" & return & errNum & return 7 
& "<H3>Date</H3>" & return & (current date) & return 
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set Petirn pase. to-Keturn page ™ On-site training is convenient — your co 

y -MacApp 
& "<A HREF=\"mailto:webmaster@your.domain.name\">" 7 and consuming down-time. “PowerPC | 
& "webmaster@your.domain.name</A>" & " of this error." 7 (a4 - AppleScript) 
oo. eae / a? Professional training & consultancy 99 ener 
_page 7 |. 
oa that really hits the mark. Debugging | 
end «event WWWQsdoc» ssourcesus a 


Call today to find out how Richey 


-- The idle event is run at idle time to save the data to disk. Software T fainings delivers pl ofessional 


on idle seminars and consulting nationwide. 
global guestFile 
global header_data RICHEY 


: Training Mac Programmers Since 1986 
707*869+2836 
AppleLink: RICHEY.SOFT 

INTERNET: 70413.2710@compuserve.com 

P.O, BOX 1809, GUERNEVILLE, CA 95446-1809 





global footer_data 


set fileRefNum to open file (guestFile as alias) 
write file fileRefNum text header_data & footer_data 
close file fileRefNum 


3 P ; A SOFTWARE 
return 1800 -- wait 30 minutes to save information TRAINING 1904 Richey Software Trtining_ Al lemurs oF raiser ralemarke a 


the property of their respective to change 


end idle 














-- The quit handler saves the data to disk before quitting 
on quit 

global guestFile 

global header_data 

global footer_data 


set fileRefNum to open file (guestFile as alias) AI Developer Tools to Support 


write file fileRefNum text header_data & footer_data 
close file fileRefNum ™ | 
Adobe Adobe™ Technologies 


continue quit 
end quit 





Adobe provides a complete set of tools and 
services for your development needs. Whether you 
want to integrate Adobe Acrobat™ capabilities into 
your applications, add PostScript™ language 
support to your products or create powertul 


Graphics Application Plug-ins, Adobe has the tools. 





These Software Development Kits now available 


od ; p Adobe Acrobat™ Plug-ins 
To receive information 


on any products 
advertised in this issue, 


p Adobe PostScript Language 
p Adobe Photoshop™ 

p Adobe liilustrator™ 

p Adobe Premiere™ 

p Adobe PageMaker™ Additions 


p Adobe Fetch™ Content Publishers 


To have information faxed to you, call (206) 628-5737 
and request documents 1220 and 1233. 


send your request 
via Internet: 
productinfo@xplain.com 





Adobe Developers Association 


1585 Charleston Road, Mt. View, CA 94039 
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By Glenn L. Austin and Levi Brown 
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This monthly column, 
written by Symantec’s 
Technical Support 
Engineers, aims to 
provide you with 
technical information 
based on the use of 
Symantec products. 


Q: When I save the position of hidden 
windows in TCL, they always end up at 
the top-left of the screen rather than 
where they were actually located. 
What's happening? 


A: CWindow::FrameToGlobalR( 
currently assumes that the window is 
visible when it is called. Therefore, you 
need to insert the following lines into 
CWindow::FrameToGlobalRO above the 
line which starts off with: 


offset = topLeft((** ((WindowPeek 


and insert this code: 
if (!visible) 
CView* oldPView = cPreparedView; 


Prepare(); 
offset.v = offset.h = 0; 
LocalToGlobal (&offset); 


if (oldPView) 
oldPView->Prepare(); 
} 


else 


Q: Why does the amount of free 
memory go down every time I bring up 
a window which contains a CArrayPane? 


A: There is a problem with 
CArray::GetFrom. Just before the line 
which reads: 
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hitems = NewHandleCanFail(elementSize): 


insert the line: 


TCLForgetHandle(hItems) ; 


Q: When I’m building static libraries, I keep getting the error: 
PPCLink encountered an error 


# Error: Non-shared libraries do not support "-main main" 
# Error: (3015) While writing 
PowerMac:Development:staticlib:staticlib1.o 

# Error: 

# Fatal error: 

PPCLink - Execution terminated! 


from Symantec C++ 8.0. What does this mean? 


A: Go to the Options... menu, select Linker, select the “- 
main main” in PPCLink settings, and delete it. 


Q: While debugging some optimized code using the THINK 
Debugger, I’m watching two of my variables in the Data 
window, and both of those variables are changing to the same 
value when one of the variables is changed. Why is that? 


A: When you produce optimized code, the compiler will use a 
register for one variable, then reuse it for a different variable 
within the same function if it can do so safely. The debugger 
associates the two variables with the same register, and you see 
the variables’ values coincide. 


Q: After updating to TCL 2.0.6, my applications now have a link 
error “CTableBorder::” not defined. Why? 


A: CTableBorder was added in TCL 2.0.6, but the source file 
CTableBorder.cp hasn’t been added to your project. Add the 
CTableBorder.cp file in the Table Classes folder to the Table 
segment of your project. 


Q: The active border for a CTable doesn’t get drawn in 2.0.6. 
Why? 


A: The table has already become the gopher by the time the 
border would be drawn. Change CTable::BecomeGopher() from: 


if (fBecoming) 
if (gGopher != this) 


to: 
if (fBecoming) 
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( 
if (gGopher == this) 


Q: I'm having problems with strcat in Symantec C++ 8.0 
trashing memory. What’s wrong? 


A: There is a problem in strcat when the second string is an 
empty string. There are three options to dealing with this string: 


(1) Use the C version of str.c rather than str.asm. 
(2) explicitly test for an empty string, ie. 
i (*t) 
streat(s, t); 
or 
(3) download the script to fix the bug in str.a from 
ftp.symantec.com. The script is located in: 


ftp://ftp.symantec.com/public/devtool/mac/updaters/ 
sym.cpp-va-tcl.updates/str.c.update.hqx 


¢ ‘ 


Q: I get an “undefined identifier ‘__nan’” when I include 
coraplex.h in my .cp files and bring my project up to date. What 
is wrong? 


A: Go to the Think Project Manager’s Edit menu, select 
Options and choose the Symantec C++ sub-option. Choose 
Language Settings in the popup menu and uncheck the 
ANSI Conformance checkbox. Also, be sure to add the 
“Complex” library from the Standard Libraries to your project. 


Q: I’ve got a 68K program which uses floating point. How do I 
convert it to run on the PowerMac? 


A: The basic solution is to use fp.h rather than math.h or 
SANE.h. fp.h will automatically include the proper header for 
the 68K or PPC compiler, SANE.h or PowerPCfp.h. 


Q: I’m having problems accessing devtools.symantec.com. Why? 


A: In order to consolidate our services, all of our files have 
been moved to ftp://ftp.symantec.com/public/devtool/mac, as 
well as our WWW service at http://www.symantec.com 


Special thanks to Mark Baldwin, Craig Conner, Rick 
Hartmann, Michael Hopkins, Steve Howard, Noah Lieberman, 
Andy McFarland, Scott Morison, and Kevin Quah. 
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Can you spot 
the difference’? 


Plenty of people can’t. Because whether you update software with a full 
set of program disks, or a file made with UpdateMaker 2, the result is 
the same. Guaranteed.UpdateMaker updates are totally reliable. 

Its system of 32-bit checksums ensures that it updates the right file. 





And UpdateMaker is easy-to-use — simply specify the files and 
UpdateMaker builds the update. There is no scripting or use of 
ResEdit. It’s even easier for end-users — just one button to press. 


UpdateMaker 2 works with any type of Macintosh file. The updater 
files are extremely Compact. And the program options numerous. 
You can preserve or override user customisations. Save files in Binhex 
format. Update up to 20 old versions with one file. 


The real difference is the savings in time and money. Which explains 
why some of the best-known names in software development have 
already discovered UpdateMaker 2. 


Distribution is unrestricted and royalty-free. 


Only $225, order now (415) 964 2878 


or Applelink:MacLab007 


UpdateMaker 2 


ats, 2225 Grant Road, Suite #4, Los Altos, CA 94024 Fax: (415) 964 2886 








DEVELOPER 











UNIVERSITY 


It’s not just the basics anymore ! 


Advanced courses from Developer University 
get you up to speed quickly on new Apple technologiess 


I OpenDoc 

1 PowerPC 

1 Newton 

I Graphics/Imaging 
I Apple Guide 


Courses Available as 


Self-Paced Classroom Lecture Online 














For more detailed information, check out our World Wide Web pages, 
http://www.info.apple.com, or contact the Apple Developer University Registrar 


at (408) 974-4897 or fax (408) 974-0544. 





Developer University, Apple Computer, Inc. 1 Infinite Loop, MS 305-1TU, Cupertino, CA 95014 





SYMANTEC Top 10 


Apple Guide 


Put the power of the leading 
on-screen help system to work for you 


We provide a full range of services to help you use 
this new technology most effectively. 





is a collection of five menu defini- 
tion resources (MDEFs) that you just 
paste into your project’s resource file. 


Build a menu using the MDEF and 
then just handle menu selections like any 
normal menu. 






Geneua 9 
30 Tools 
Colors > 
ASCII Chart 
This Year & Diamond § 






* Contract guide file development -- give us your 
requirements and we will work with you to determine 
the best uses of Apple Guide in your application. 







¢ Development services -- we can provide instructional 


design, content, scripting, and custom engineering 
Also contains Maitre d’, a special menu develoment tool to speed up your guide file development. 


that assists you in designing your MENU MILL Menus. 


: ae ; Telephone: 408-895-1158 
-Use your drawing programs as programming tools 
- Fast unobtrusive RGB color picker Contact internet: powers @guideworks.com 


- Space saving Geneva 9 MDEF WWW: http://Katz.guideworks.com 


- Calander Menu ‘ 
Write, Ariel Publishing, Inc. | 
11A Leisure Time Drive, 


Diamondhead, MS 39525 ee : 
ao) 69 J 5 Call (601) 255-6713 ntelligent Assistance Solutions 


FAX (601) 255-7086 , 
DEVELOPED BY STAZ SOFTWARE, INC guideWorks, LLC 168738 Alexander Avenue Monte Sereno CA 95030 


¢ Technology transfer and training - we will help your 
staff develop Apple Guide expertise. 








DON’T FORGET! 


To receive 


information 


on any products 4) 1 Track 
advertised in CS ae 


Bug Tracking the Macintosh Wa 
this issue, : . : 


send your request 


via Internet: 


productinfo@xplain.com 


For more information, call or send e-mail to seapine @ one.net 


1066 Seapine Court 
Maineville, OH 45039 
513.683.6456 








Good News for 
Macintosh Developers: 


Order ETO, today and get the Mac’ OS SDK and 
Apple Developer Mailing for only $99 more (a $450 savings) 






Now E..0,, the deluxe collection of core programming tools on CD, offers more value, convenience and up-to-the-minute technology than ever before. 


It includes an integrated set of development environments, compilers, debuggers, application frameworks, testing 
tools, and provides streamlined application development for 68K and 
Power Macintosh systems. With the versatility of two powerful 
environments—MPW Pro, Apples Macintosh Programmer’ 
Workshop, and the popular Symantec C++—you can easily , 
switch between them and use the one that best suits your needs. 
An Apple exclusive, E.T.0. is sold as a convenient subscription 
with new releases and tool updates automatically sent to you. So your 







POVSLL/ A 


tools are kept up-to-date all year long. 


Now, for a limited time, you can have all the value and versatility of E.T.0.— plus more. 
Not only does E.T.O. save you time and money, but you also get an opportunity to order two more 
exclusive Apple subscription products at a special price. For only $99 more ($1,194), you get E.T.0. 


E.T.O.: Essentials ¢ Tools « Objects 
Complete First Year Package 
with the Mac OS SDK (Software Developer’ Kit) and the Apple Developer Mailing, two convenient $1 (195 
) 


subscriptions that provide everything you need to move to the top as a first-class developer 


Hurry, offer expires July 31, 1995. 


(M089SLL/C: 1 starter kit plus 2 CD mailings) 
Once you subscribe to E.T.0., renewal fees are only $400 per year. 


How to Order 


To order call: 


1 800 2822732 





Mac OS | 


Software Developer's Kit 








Mac OS SDK 
More than 30 System Extensions in One Convenient Product 


$299 
(RO603LL/A: 4 CD mailings.) 
The Mac OS SDK is a comprehensive assortment of powerful system technologies that 
will assist you in developing the world class applications of the future. You get convenient 
and affordable instant access to over 30 popular Macintosh system software extension 
SDKs that Apple publishes, including QuickTime, AOCE, QuickDraw GX and MacTCP 
Mac OS SDK provides all the software and programming information you need to add 
support for system software technologies in your applications. 


Or ask for a free copy of the 
Apple Developer Tools Catalog 
VISA, MasterCard and AMEX accepted. 





Apple Developer Mailing 
Important Monthly Industry Updates and Essential Technical Information 


$250 

(CO197LL/A: 12 issues) 
The Apple Developer Mailing provides you with the latest technical information you 
need to stay up-to-date on Apple programming and at the top of your industry. The 
mailings include: Apple Directions, Apples monthly developer business 
report, and The Developer CD Series, a comprehensive information 
resource, including on-line technical documentation, system software 
and programming utilities. 





©1995 Apple Computer, Inc. Apple, the Apple logo, Macintosh, MacTCP MPW and QuickTime are registered trademarks of Apple Computer, Inc. AOCE, Mac and QuickDraw are trademarks of Apple Computer, Inc. Offer expires July 31, 1995. 
Prices above do not include tax and shipping. Call for information on renewal fees. Prices and products are subject to change without notice. Offer not valid in conjuction with any other Apple offer. E.T.0. credits for MPW, Macintosh on 
RISC SDK and/or Symantec C++ do not apply to this special bundle offer. To place orders from Canada: Call 1 800 637-0029; Outside North America, call: 1716 871-6555 or fax inquiries to 1716 871-651. 
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INSIDE INFO 





By Chris Espinosa, Apple Computer 








Schemers 





INSIDE INFO 


Al summer the news has been full of 
big deals and grand schemes in the 
computer industry. The most notable 
ones are the failed Microsoft acquisition 
of Intuit, and the IBM purchase of Lotus 
Development. 

(It’s funny that, five years ago, 
IBM’s purchase of Lotus would have run 
into major anti-trust problems, but 
Microsoft’s bid for Intuit might have 
gone unnoticed. But that just shows 
how much changed from 1990 to 1995). 

The interesting thing about these 
deals is that they were seen as not just 
normal bids to broaden a product line 
or buy market share, but rather as the 
first play in intricate schemes. 
Microsoft’s acquisition of Intuit, if you 
recall, was not just a trade of a losing 
position in home finance software for a 
winning one. It was seen as the 
foundation for a massive Pynchonian 
scheme to control electronic banking 
and commerce, wired into the Microsoft 
Network, credit cards, video-on-demand, 
new forms of software distribution, and 
even the nature of money itself in the 
new century. Pretty heady stuff for a 
checkbook program. 

And IBM’s Lotus move was not 
simply to buttress a traditionally thin 
applications offering from the world’s 
largest computer company: it was a 
strategic play to control corporate 
client/server application development 
and internal communications, and place 
IBM mainframes, servers, and 
communications back in their rightful 
role as the backbone of the world’s 
corporate information structure. 


Doubtless some of the executives of the two firms were 
harboring dreams like these. And maybe these schemes 
swayed the finance types and board members who normally 
cast a cold eye on big-money transactions. But the reality of 
the industry is that for every big scheme that works, plenty fail. 

The failures are quickly forgotten. Perhaps the biggest was 
IBM’s System Application Architecture (SAA), a grand scheme to 
unify the PC, mini, workstation, and mainframe lines under a 
single family of operating systems, user interfaces, and 
communications protocols. The downfall of SAA was its 
largeness. So many constituencies wanted the standards to 
address their needs that the standards were simply generalized 
to cover everything that existed, and all the benefits of 
convergence were lost. Apple, too, had a grand scheme in 1992 
called “client/client/server,” where desktop Macs, PDAs like 
Newton, and Unix-based servers would all be united under a 
common set of protocols and APIs. 

Microsoft is the current king of schemes, some fruitful (like 
the Microsoft Office) and some less so (like the ACE initiative, 
Microsoft At Work, Windows for Pen Computing, OS/2 as the 
replacement for DOS, Windows NT as the replacement for DOS, 
and Windows 95 as the replacement for DOS). 

But there have been three big schemes these companies 
that have worked tremendously well. And what they have in 
common is that they were just simple ideas that were only seen 
as schemes after the fact. 

IBM’s big win was making the IBM PC architecture 
dominate 80% of the computer market in about two years, 
displacing the CP/M and S-100 Bus architecture and blowing by 
the Apple II, Commodore PET, and other competitors. They did 
this by doing things common to their competitors but entirely 
out of character for IBM. They bought their OS from someone 
else; got others to write applications for them; and even 
published the circuit diagrams of the computer. The scheme 
was to dominate by having the most hardware and software 
add-ons. What really happened, of course, was that Compaq 
cloned their machine, as did hundreds of others. IBM ended up 
with less than ten per cent of the IBM market. But the market 
was many more times larger than it would have been if IBM 
had sold yet another closed box. 
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Apple’s successful scheme was to avoid IBM’s mistake. 
With the Macintosh, we encouraged lots of consistent third- 
party software by having a huge amount of built-in system 
software and heavily promoted design guidelines. But we kept 
the design proprietary to ensure a virtual 100% market share of 
the GUI segment, which we had for eight years. And even 
today, when people write that the Mac is easier to upgrade, 
maintain, learn, and use than a clone, they hastily follow that 
with “but it’s only available from Apple,” as if they do not see 
that the latter was the cause of the former. 

Microsoft’s scheme, of course, was to come from nowhere 
in the applications business to near-total domination in three 
years by shifting the system software from DOS (which Lotus, 
Word Perfect, and Ashton-Tate dominated) to Windows (which 
looked a lot like the platform that Microsoft applications 
dominated — namely, the Macintosh). 

These schemes were simple in concept, executed well, and 
made billions of dollars for the companies involved. They 
didn’t have to be an ounce more intricate, or have any sinister 
motives or actions. They weren’t even recognized as strategies 
at the time, and were even called bad business decisions by 
some, but the results speak for themselves. 

And all the schemes cooked up by those companies 
afterwards have not come close to matching the success of the 
originals. Maybe there’s a lesson there for companies both big 
and small: keep your schemes simple, execute them doggedly, 
and don’t be any more clever than you have to. 
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Text editing for your Macintosh. Preditor brings 


together Macintosh ease of use and a powerful set 
of features to give you the definitive editor. Con- 
tact us today and adopt Preditor for your machine! 


@ File Edit Search Modify Special Tools Debug Window BE 10:37:55 PM fe 


re ce Col: O 


r 


Language Module Builder 





This file describes how to use the libraries and tools in this 
build your own language module for the Predftortext edith=; 
an existing language (but with improved/modified parsi 
language that is not included with the Preditor release 


There are 3 major steps in creating a language module 


* Sort file list in alphabetical order, but put volumes first 
*/ 


static int ..droyveersoribrac’ 
fi leSpec *s1, 
i * 
through the “Language Module Builder" application. , leSpec a 
3. Compile the parsing source { 


1. Create the language module resources 
2. Compile the language module by running it 


if (si->par!lD == 1 && s2->parID != 
return(-1) 

Creating the language module resources (st->par ID != 1 && s2->parID == 
nore return(1); 

There are a variety of resource types in the language moduysns 


A (strPSt <<Char * > 
define the language. They are: return(strPStringCompare ar s1->name 





} 
* predSetBrowserFileList 


* Filter function for filelistS 
* matoh our file type and fil 
*/ 











E-Mail: evatac @access.digex.net 
WWW: hitp://www.access.digex. 
net/~evatac/evatac.html 
Voice: 703 620 0669 


iptWizar 


2 = 
Ne 
ui g 


Version 1.5 


Now shipping. With all the new features that you asked for. 
ScriptWizard™ is the best-selling script-editing and debugging 
tool that combines the power of a professional development 
environment with the ease of use that you expect of Macintosh® 
software. ScriptWizard improves your productivity by delivering 
testing and debugging facilities that are as intuitive as they are 
powerful, including a Variable Watcher, true single-step debugging, 
rapid script navigation, and more. 


New features... 

e True AppleScript statement—level single stepping. 
e Scriptable and Recordable. 

¢ Improved text editing, with drag and drop. 
e"Native" for both Power Macintosh and 68K. 

¢ Quick access to Dictionaries from a new menu. 
¢ Full control over Toolbar position & visibility. 
¢ Re-sizable panes in windows. 

¢ Projector-aware for source code control. 

e Edit and debug scripts for FaceSpan 2.0. 

© and much, much, more... 


US Orders: 800 799 4737 


Also available in the US from APDA, and Heizer. 
Full Moon Software. Internet: 'sales@fullmoon.com' 
International Orders: Tel +44 1628 660242. Fax 666084. 


US price 
still only 


$99 














By John Kawakami, MacTech Magazine Editorial Assistant 








USERLAND FRONTIER IS FREE! 


Most of you should know by now that UserLand Software has 
made Frontier 4 free. No retail price. No license fees. Free. 
It’s all part of Dave Winer’s plan to increase Frontier usage, 
especially to automate tasks on the world wide web, and as 
the preferred platform for Macintosh scripting. 

Most interesting is the improved interface between 
Netscape and Frontier. Now, it’s possible for a URL to 
contain a Frontier script that is executed on the user’s 
machine. As if by magic, the webmaster can gain greater 
control of the Macintosh user interface, performing tasks 
which were previously impossible. 

Frontier, in current and previous version, has always 
made it’s rich collection of verbs available to people using 
other scripting systems such as AppleScript. So the many 
AppleScripters will gain a great deal from Frontier’s new 
“free” distribution. Everyone should check out the first URL 
below; the site is often busy, so you may have to make 
several attempts, but it’s worth the effort. Frontier is also 
described in TidBITS 279. 
http://www. hotwired.com/Staff/userland/aretha/index.html 
http://www. hotwired.com/Staff/userland/beingfree_220.html 
http://www.hotwired.com/Staff/userland/mylittlesymphony_223.html 
http://www.dartmouth.edu/pages/TidBITS/issues/TidBITS-279.html 





WELCOME, COMP.LANG.PASCAL.MAC 


The following was recently spotted on the Usenet. 


Subj: **** WELCOME TO COMP.LANG.PASCAL.MAC: PLEASE READ **** 
Date: Tue, Jun 13, 1995 11:12 AM PST 
From: sam@ccnet.com (Scott A. Moore) 


RREKEKKKKK KKK KERR KKK KERR KR KR KR KEK KK KEKE KEKE KEKE KEKE KEK KKK KEKE KKK KE KKK KKK EE 


=====—== WELCOME NEW USERS === 
TO COMP.LANG.PASCAL.MAC ! 


It is my privilege to officially open this group for 
posting. This group was created by your votes on June 12, 
1995, 


PURPOSE 


This is the group for discussion on Macintosh Pascals, 
including Apple Pascal, THINK Pascal, CodeWarrior Pascal and 
others. All aspects of Pascal on the Macintosh are 
discussed. 





SOS CORPORATION RELEASES INTERNET FIREWALL FREEWARE 


SOS Corporation announces the release of Freestone (TM), a 


EW NEWSBITS 


freeware, firewall construction software suite. The Freestone 
suite of self-contained programs and utilities is used to create an 
application gateway, bastion-host firewall for TCP/IP networks. It 
is designed to provide user-level security for LANs connecting to 
public networks, such as the Internet. Freestone is an ideal 
solution for any organization which has the resources to build 
and maintain a firewall, with a need for a dedicated Internet link. 

Freestone offers fine-grained control over both ingoing and 
outgoing network traffic on a per-user basis. This robust access 
control is unsurpassed by any freeware firewall currently 
available. Freestone provides user access control based upon 
source and/or destination address, source and/or destination 
port, time of day, day of the week, date of the month, month of 
the year, and system-defined holidays. 

SOS Corporation, which develops and markets several 
commercial computer network security products, including the 
popular Brimstone application gateway firewall, is making 
Freestone available via the Internet. To download the package, 
users may FTP to one of the following Internet sites: 
ftp://ftp.cs.columbia.edu/pub/sos (the preferred site) or 
ftp://ftp.soscorp.com/pub/sos 

Users may download and install the firewall software free 
of cost and without license, provided that they do not 
repackage, sell, license, or in any way use the suite for 
commercial purposes. Building and installing a firewall with 
Freestone requires a solid understanding of UNIX and network 
services, such as DNS, TELNET and FTP. The suite contains 
documentation, as well as files with integration advice and 
pointers to Internet and public domain resources. 

To subscribe to the Freestone mailing list, send e-mail to 
freestone@majordomo.soscorp.com, and include the word 
‘subscribe’ in the subject heading. 

SOS Corporation: (212) 686-5700, e-mail sales@soscorp.com 
http:/www.soscorp.com 





FREE UPDATES TO LS FORTRAN FOR THE POWERMAC 


Language Systems offers free patches and upgrades to their 
products on their ftp server. The latest patch currently available 
for LS FORTRAN is version 1.1a6. It is based on LS 
FORTRAN.PPC version 1.0. The major upgrade v1.1 will be 
mailed to all registered 1.0 users. 

Electronic updates are now available from the anonymous 
ftp site, langsys.com, directory pub/langsys. 
Language Systems: (703) 478-0181, email LANGSYS@aol.com 


ftp://langsys.com/pub/langsys 
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ALLEGIANT OFFERS INTERNET XCMD, 
ALSO FREE MULTIMEDIA TOOLS WITH SUPERCARD 


Allegiant Technologies, Inc. previewed their new Internet 
connectivity program, code-named BlackHole, during WWDC. 
BlackHole allows the rapid creation of completely customized 
interfaces that automate and simplify Internet tasks. The 
product is expected to ship in the Third Quarter, 1995 at a price 
of $249. 

BlackHole gives the Internet a scriptable interface, allowing 
people familiar with scripting languages on the Macintosh to 
build custom TCP/IP client and server applications. They will be 
able to create these applications in any authoring environment 
that supports both inter-application communication and the 
standard external command (XCMD) interface, most notably 
Allegiant SuperCard 2.0 and Apple’s HyperCard. 

BlackHole provides a familiar high-level interface to the 
standard Internet protocols that include standard e-mail 
(SMTP/POP3), file transfer (FTP), newsgroup (NNTP), 
HTTP/CGI and Gopher. The program ships as a system 
extension that utilizes Apples Thread Manager for smooth 
background operations. An external code module, optimized 
for standalone performance and delivery within SuperCard- 
based applications, will also be included in the package. 
BlackHoles Task Manager manages the completion of lengthy 
operations either while the user works or deferred until a pre- 
designated time. 

BlackHole will allow corporate MIS directors, 
researchers, educators, Internet service providers and net- 
surfers to create a wide variety of specialized applications. 
Examples of these custom applications include simplified, 
automated Web page creation and maintenance; utilities for 
corporate in-house or field personnel; workgroup E-mail 
distribution; off-line newsgroup reading; easy mailing list 
management; automatic web link verification utilities; 
collaborative tools, and much more. 

BlackHole is expected to ship early in the Third Quarter, 
1995 at a price of $249. A demo version of the system 
extension will be available from Allegiants home page when 
the product ships. Exact pricing for commercial licenses to 
distribute the extension or the code module will be made 
available at a later date. 

Allegiant also announced a new retail bundle, the 
Multimedia Graphics Production bundle. Until August 31, 1995, 
SuperCard 2.0 will include the latest versions of award-winning 
Ray Dream Designer, Kai’s Power Tools SE from HSC Software, 
and Micro Frontier’s Color It! Designer is a 3D modelling and 
rendering program, Kai’s Power Tools SE is a 15 filter version 
of KPT’s popular image processing filters, and Color It! is a 
image processing program. The suggested retail pricing of 
SuperCard 2.0 is $695, with typical street pricing of $399. 
Upgrades for current users is $149. 

Allegiant: (619) 587-0500, email allegiant@aol.com 
http://www.allegiant.com/~supercrd/ 
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APPLE DEVELOPER UNIVERSITY OFFERS QD3D COURSE 


Apple Developer University is offering a 3-day course in using 
Apple’s exciting new QuickDraw 3D graphics library. This 
course teaches you the basics of creating, manipulating and 
rendering three-dimensional objects in your applications. You 
will also learn about the new 3D human interface guidelines 
and Apple’s new metafile format for reading and writing 3D 
objects. The course consists of a series of hands-on labs (using 
C), as well as lectures. 

Developer University offers training and educational 
material covering Macintosh and MacOS programming. 
Developer University: (408) 974-4897, 
email devuniv@applelink.apple.com 
http://www.info.apple.com/dev/du.html 

Also, QD3D additions to the Toolbox Assistant are 
available from: http://www.info.apple.com/dev/MPTA.html 








ZINC 


Zinc Software has released version 4.1 of Zinc Application 
Framework, its award-winning C++ class library and visual 
development tool. Version 4.0 gained critical acclaim, receiving 
two key industry awards: The “Analyst’s Choice” Award from 
PCWeek LABS (January 30th, 1995), and InfoWorld’s “Best 
Portability” rating (February 6, 1995). 

Zinc 4.1 allows software developers to create globally- 
enabled, object-oriented, cross-platform applications with one 
set of source code. The numerous additions and enhancements 
in version 4.1 include: 


e anew IMAGE object, allowing the display of large bitmaps 
from native file formats. 

e anew FILE object, allowing Zinc applications to read and 
write portable binary files on any operating system. 

e new CTL3D support for Windows, improving the look of 
Windows applications. 

e an improved Help display, with ease-of-use enhancements 
and a facelift. 

¢ support for dot-matrix printers in MS-DOS applications. 

e easier function names, designed to reduce developer 
learning curves. 


Version 4.1 also introduces Zinc’s new Customer Assurance 
Plan (CAP), an annually-renewable membership plan 
combining Zinc’s excellent technical support and product 
maintenance programs. 

Zinc, North America: (801) 785-8900, email info@zinc.com 
CompuServe: GO ZINC 

Zinc, Europe (UK): +44 (0)181-855-9918, email europe@zinc.com 
Zinc, Asia Japan): +81 (052) 733-4301, email asia@zine.com 





NEWSBITS EI 


The Trattner Network, the digital talent source, wants experienced Macintosh 
developers to perform a variety of consulting assignments in Northern California 
and Nationwide. We bring 10 years of experience to the Macintosh consulting and 
placement industry, offering a unique blend of humanistic interaction and 
technical knowledge. 

If you are looking for a great opportunity to enhance your skills, team with the 
best, have fun and make lots of money, please send, fax or email your resume to us. 


w Showing I! 


win! Wanted: 


evelopment in: 


Openvox a Software Developers 
Newton |-—I- Firmware Engineers 


PowerPC | QA/QC Professionals 


Metrowerks : : 
Notebooks ————- Multimedia Developers 


Machpp iE Project Managers 


and many others oon Network Professionals 


The Trattner Network 


attn: Nyla Miller 
170 State St. Suite 240, Los Altos CA 94022 
Phone (415) 949-9555 Fax (415)949-1026 
AppleLink: trat.net email: nmiller@tratnet.com 
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Developer Job Opportunities 


If you are a Macintosh developer, you should register with 
us! We havea database that enables us to let you know about 
job opportunities. When we are asked to do a search by a 
client company the database is the first place we go. There 
is no charge for registering. The database service is free. 
Geographic Coverage is nationwide. 


YOU DONT HAVE TO LIVE IN THE URBAN JUNGLE 10 
DO WORLD-CLASS PROGRAMMING FOR EXCITING PRODUCTS! 











Marketability Assessment - To get a specific feel for your 
marketability send a resumé via Email or call. You may also 
request a Resume Workbook & Career Planner. 



































Discreet - We are very careful to protect the confidentiality community js ust a short drive from some ne of the nation’s premier sporting 


of a currently employed developer. 


Scientific Placement is managed by graduate engineers, we 
enjoy a reputation for competent & professional job place- 
ment services and we are Mac fanatics. 


1-800-231-5920 | das@spi.com | Fax 1-800-757-90 03 


Scientific Placement, Inc. 


MT, Box 19949, Houston, TX 77224, 713-496-6100 Fax: 713-496-0373 AOL: davesmall 
MT, Box 71, San Ramon, CA 94583 510-733-6168 beth@spica.bdt.com 
MT, Box 202676, Austin, TX 78720-2676 512-918-3785 lej@zilker.net 
MT, Kenmore Station, Box 15225, Boston, MA 02215 617-424-8372 jen@spbos.pn.com; 
AppleLink: D1580; Compuserve: 71250,3001; eWorld: spi 


re a 


— 


“deat Tarn Systems, Inc. 
P.O. Box 8036, Wisconsin Rapids, WI 54495-8036 
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__Learning Systems, Inc. 
















































mm, Flyin’ down hills 

7] faster than 
our VP's 
Tsumami. 
(almost) 


Dilbert® by Scott Adams 


NY TRIP TO ELBONIA 
WAS A COMPLETE 
SUCCESS . 


1 OPENED OUR SUBSIDLARY, 
TAUGHT CAPITALISM TO 
THE LOCALS AND SHOWED 


OH GREAT... 
NOW THEY DON'T WORRY. 


WILL BECOME 


Larry Bunch 





THEM HOW TO MAKE AN INDUSTRIAL THEM OUR paseiiiba 
COMPUTER CHIPS OUT OF GIANT AND MANAGEMENT and Spoked 





COMPETE TECHNIQUES. 


AGAINST US. 
D ) L- 







Man Nip MT dE | 
tall erts Has openings for 
progr ers experienced with 
C++ and Toolbox . Ifyou have 
what it takes; and.the desire to 
achieve, call dall Tyler at: 
Voice: 800-356-8040 Fax: 804-358-3847 
Internet: xperts@richmond.infi.net 
AOL:MacXperts Applelink:Xperts 
http renee macxperts.com/~xperts 





ScottAdams@aol.com 













reprinted by permission of UFS, Inc. 
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TASTES LIKE CHICKEN! 


Without secure software, even the most expensive 
hardware key is nothing but a chew toy 


71 




















You need to protect your software. Hardware vendors will try to convince 
you that hardware keys are the only secure method of protection. 
They're wrong. 





‘ Protection is only as effective as the software involved. Most hardware key ANTI-PIRACY 
® vendors require that you, the developer, spend major resources protecting 
; and obscuring the code which interacts with a key. Without this effort on 


“Our Japanese font supplier imposes 
| your part, your software is vulnerable, even to inexperienced hackers. 


strict copy-protection obligations 
At PACE, we understand that software is the most important on Adobe Systems. Because of this, 

». component of a working protection system. For more than a we have been using PACE software 
_ decade we’ve developed low cost and secure software based protection on Adobe Type Manager, 
protection schemes. Our MacEncrypt system will turnkey Japanese version and our other 
protect your application automatically, applying multiple layers of PACE Japanese font products for almost 
proprietary encryption and self checking algorithms to your product. 5 years. PACE’s software solution 


MacEncrypt is a secure, flexible, compatible and low cost protection provides us with effective security at 


investment. No false promises, wasted development time, upset users a low cost. Our working relationship 
or expensive chew toys. 


with PACE is excellent and 
= & Trust the protection of your software to the people who understand their expert technical staff bas 
| software. Call today to order your PACE Developers Kit. always been helpful. 
Paul And 
| PACE Anti-Piracy 1082 Glen Echo Ave., San Jose, CA 95125 Senior Diener ie Rim 
Vox: (408) 297-7444 * Fax: (408) 297-7441 © AppleLink: PACE.AP 


Adobe Systems, Inc. 
email: info@paceap.com * Web page: http://paceap.com/pace.html 


The magazine has grown so that we need more space 
to serve the Macintosh Developers Community. 


All e-mail addresses remain the same (see page 2). 
Our new voice, fax and address are as follows: 


For Macintosh 
Programmers & Developers 


P.O. Box 5200 
Westlake Village, CA 91359-5200 
Voice: 805/494-9797 
Fax: 805/494-9798 








By Neil Ticktin, Editor-in-Chief/Publisher 








INTERNET COVERAGE ... KEEP IT COMING 


I am very pleased with the May ‘95 issue, in particular with the 
article by Jon Wiederspan, “Your Very Own Web Server — 
MacHTTP”. When I got back into programming after doing 
other things for several years, I balked at learning the Symantec 
C environment (give me a quick and dirty batch file for compile 
and link any day) and the 5,000,000 system calls for the Mac OS. 

Besides, what I really wanted to do was play on this 
Internet thing I kept hearing about. So I ramped up on serial 
communications, plowed through Adam Engst’s Internet Starter 
Kit for Macintosh, surfed for HTML tutorials, got enlightened 
with Netscape, and then slammed head-on into the roadblock 
of UNIX and the Local Internet Provider. 

Based on my experience with my soon-to-be-ex provider, 
the biggest problem with newbies getting on the Net isn’t with 
the technology learning curve, but with the local access 
provider, that promises high speed and reliable lines, full Net 
access, and the ability to publish Web pages. Those promises 
turn to dust, however, as soon as they’ve been paid, just like 
used car salesmen. 

To get around the service provider “roadblock,” ’'ve begun 
to learn UNIX, and have considered setting up my own HTTP 
server, so that I would have a better understanding of how the 
Web works, which would allow me to avoid being BS’ed by the 
Provider. So Jon Wiederspan’s article couldn’t have come at a 
better time. 

Please continue to publish articles on the behind-the- 
scenes mechanics of the Web and other Net server/clients. 
Integrating the HTTP server with a database would be a good 
topic, especially if the ‘base contained different media. For 
instance, The California Museum of Photography web site, at 
the University of California, Riverside, runs off of a MacHTTP 
server and serves pictures.(see http://cmp1.ucr.edu/) 

I hope that Jon Wiederspan’s article won't be the last one 
on Mac based HTTP servers, and that there will be more about 
the other behind-the-scenes mechanics of the Internet. These 
server-side articles would be invaluable to the Net community, 
as well as to the Internet consumer. 

— Stephen McManus 


[You asked for it— you got it. In this issue and in the last issue 
(July), you have a two part series on CGIs. Jon will continue to 
give us coverage of Internet related topics and how they relate to 
the Macintosh development community. Let us know what you 
think and what more you'd like to see! Ed. - nst] 
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THERE IS A REASON! 


In the July issue of MacTech, Guy Nicholas asks, and Neil 
Ticktin echoes, the question: “If they care, why doesn’t Symantec 
use .SYM debugging information, since it’s a standard?” 

There are a couple of technological reasons: First, the SYM 
format is not well suited for incremental-linking environments 
like Symantec C++. The .SYM format is designed around the 
older operating model which entails doing a complete build of 
the application, including the link step, and then running the 
resulting program with a separate debugger. This works well 
with MPW, but many of us are familiar with MPW’s performance 
(or comparative lack thereof, Steve Jasik’s IBS notwithstanding). 
As a counter-example, Metrowerks CodeWarrior also uses the 
SYM format, and it works well with CodeWarrior, because 
CodeWarrior performs a complete link and build of the 
application (and it does so very quickly), and runs the program 
under test with a standalone debugger. 

THINK C/Symantec C++ has always linked incrementally, and 
so it’s not practical to use a debug-table model that’s built around 
a full link step. (magine having to do a “Build Application” 
whenever you wanted to debug your program.) Symantec C++ 
8.0 does take a different approach to linking, and so it’s 
conceivable that the debugger could understand the .SYM format. 
But this brings us to the next significant technological issue: 

The .SYM format is limited. If your debugger is .SYM- 
driven, then you’re constrained by the amount of information 
that’s recorded in the SYM file. One of the greatest strengths of 
the old THINK C debugging environment (which is carried 
through in Symantec C++) is that the debugger has access to 
(for all intents and purposes) the same symbolic information 
that the compiler has access to, for a given context. In some 
instances the debugger calls upon the compiler to evaluate 
expressions. This means that, for example, you can use macro 
names and function calls in an expression in the Data window, 
which is something you can’t do in any .SYM-format debugger 
today. Of course, the .SYM format may someday be extended 
to support this kind of debugging, but right now, it doesn’t. 

The point of all this, I guess, is that a company’s choice of 
technological paths is rarely, if ever, driven by whether or not 
(or how much) the company “cares”. The choice and 
implementation of technology is instead driven by the character 
of the problem that needs to be solved, and by the design 
constraints extant at the time. 

— Rich Siegel 
Founder, President, 6 CEO 
Bare Bones Software, Inc. 





DIALOG Box EJ 


RESOURCE 
LOCATORS 





By John Kawakami, online@xplain.com 








Spare your fingers and find this list online at: 
http://www.class.com/MacTech/URLs.html 


Internet-related Material 


Bolo http://bolo.ncsa.uiuc.edu/ 
Consensus http:/Awww.consensus.com:8300 
CU-SeeMe http://www. jungle.com/msattler/sci-tech/comp/CU-SeeMe/ 


DigiCash http:/Awww.digicash.com/ecash/ecash-home.html 
Info-Mac Searcher —http://www.mid.net/INFO-MAC 
Internet Config ftp://ftp.share.com/pub/internet-configuration/ 


InterNIC http:/Awww.internic.net/ 

ISP FAQ http:/www.amazing.com/fag.html| 
ISDN page http://alumni.caltech.edu/~dank/isdn/ 
Peter Lewis ftp://amug.org/pub/peterlewis 


MacWeb 
http://galaxy.einet.net/EINet/MacWeb/MacWebHome.html 
Mailing lists catalog http://ici.proper.com/mac/mailing-lists 
Matthias Neeracher —_http://err.ethz.ch/members/neeri.html 
MERIT Software Archive Searcher 
http://pubweb.nexor.co.uk/public/mac/archive/welcome.html 
OpenTransport/TCP — gopher://seeding.apple.com (in ess:public) 
Outland ftp://ftp.outland.com/ 
Portable Net. Graphics http://sunsite.unc.edu/~boutell/ong.htm| 
Eric Scouten (TCP) http://www.metrowerks.com/tcpip/index.html 
SGML, Info http://www.sil.org/sgml/sgml.htm| 
C Parser ftp://ftp.jclark.com/pub/sgmls 


C++ Parser ftp://ftp.jclark.com/pub/sp/ 
WebSTAR (see also WWW) 
Mailing List http:/Awww.biap.com/machttp/mailing_list.html 


Registry http://www.ape.com/machttp_talk 
WWW, Jon W. Mac WWW Development Guide 
http://www.uwtc.washington.edu/ComputingWWW/MacDirectory.htm| 
CGI demo/info http://charlotte.acns.nwu.edu/mailtools/ 
ftp://acns.nwu.edu/pub/jInstuff/mailtools/ 

Intro. to WWW http:/Awww.eit.com/web/www.guide/ 

Web66 http://web66.coled.umn.edu/ 

Non-Mac servers 
http://www.w3.org/hypertext/WWW/Library/Status.html 


New Technologies 
AOCE ftp://ftp.andrew.cmu.edu/pub/aoce/ 
http:/www.contrib.andrew.cmu.edu/usr/jbbt/aoce/aoce. html 


Apple, ftp ftp://ftp.info.apple.com 
Web interface to ftp http:/Awww.info.apple.com/cgi-bin/lister-pl 
DTS http://www. info.apple.com/dev 
Tech Notes http://www. info.apple.com/dev/technotes/Main.htm| 
see also http://www.austin.apple.com 
Dylan http://www.cambridge.apple.com/ 
see also ftp://cambridge.apple.com/pub/dylan 
see also http://legend.gwydion.cs.cmu.edu:8001/dylan 
see also news://comp.lang.dylan 
Mailing list archive _ ftp://cambridge.apple.com/pub/dylan/mail-archive/ 
Marlais ftp://ftp.cis.ufl.edu:/pub/src/Marlais 
http:/Awww.cis.ufl.edu/~jnw/Marlais/ | 
Mindy ftp://ttp.bdt.com//home/beard/Mindy-PPC sit. bin 
Kaleida http:/www.kaleida.com/ 


OpenDocBento/SOM = http:/Awww.cilabs.org/pub/cilabs/tech/ 


EY UNIFORM RESOURCE LOCATORS 


http:/Awww.info.apple.com/dev/du/intro_to_opendoc/iod0_index.htm| 
http://www.acl.lanl.gov/sunrise/DistComp/OpenDoc/overview.html 
http://www.eng.uci.edu/~sroussey/NetVision/software/od_parts/ 
OpenTransport/TCP gopher://seeding.apple.com (in ess:public) 
ftp://seeding.apple.com/ess/public/mactcp/MacTCP_Dev_Kit 


PowerPC http://power.globalnews.com/ 
Quickdraw GX, Apple http://www. info.apple.com/gx/gx.htm| 
Fanclub http://aah.residences.ulaval.ca/quickgx/quickgx.htm| 
Lawrence D’Oliveiro http:/Avww2.waikato.ac.nz/\do/gx/index.htm| 
Quicktime http://quicktime.apple.com/develop.html 
see also http:/Awww.info.apple.com/dev/devinfo/quicktime/quicktime.htm| 
Taligent http://www.taligent.com/ 


Other Programmer Resources 


Ada ftp://ftp.seas.gwu.edu/pub/ada 
Applescript ftp://gaea.kgs.ukans.edu/applescript 
John Pugh http://www.infoworkshop.com/~jonpugh/ 


Brian Bechtel http:/Awww.info.apple.com/dev/geeks.html 
Nicholas DiMello http:/Awww. pitt.edu/~nick/ 


Get1 Resource http://www.asel.udel.edu/~haynes/g1r.html 
Forth, MOPS http:/Awww.netaxs.com/~jayfar/mops.html 
Robert Lentz 
http:/www.astro.nwu.edu/lentz/mac/programming/home-prog.htm| 
Lisp, MCL http:/Avww.digitool.com/ 
General http://www.cs.rochester.edu/u/miller/alu.htm| 
MacHack http:/Awww.consensus.com:80/~machack/ 
see also http:/Awww.macgroup.com/MacHack.html 
Mac Progr. FAQ ftp://ftp.nada.kth.se/pub/hacks/mac-faq/mac-faq.html 
MacTech ftp://ftp.netcom.com/pub/xp/xplain 


Dave Mark (source code for his books) 
ftp://ftp.u.washington.edu/pub/user-supported/DaveMark 
Matthew Xavier Mora http://xavier.sri.com/umpg/umpg.html 
Matthias Neeracher —_ http://err.ethz.ch/members/neeri.htm| 
nick.c good for beginning Macintosh programmers! 
http://www. pitt.edu/~nick/ 


Francois Pottier http://acacia.ens.fr:8080/home/pottier/index.htm| 


also news://comp.sys.mac.digest 
Digests archive _ftp://ftp.dartmouth.edu/pub/csmp-digest 
Frontier http://www. hotwired.com/Staff/userland/ 


Jon Pugh (AppleScript) ftp://ftp.netcom.com/pub/jo/jonpugh/homepage.htm| 

Paul Robichaux http:/www.fairgate.com 

Scripting (see also, AppleScript, Frontier) 
http://mmm.dartmouth.edu/pages/macscripting/macscripting-home.html 

Source code, Apple —http:/Avwww.info.apple.com/dev/devinfo/macsourcecode. html 
also Apple http:/Awww.info.apple.com/dev/source/index.htm| 


also UMich ftp://mac.archive.umich.edu/mac/development/source/ 
also M. Neeracher _ftp://ftp.switch.ch/software/mac/sr/HTML/Welcome.htm| 
TCL ftp://daemon.ncsa.uiuc.edu/TCL/ 
see also http://rhino.harvard.edu/dan/TCLArchive.html 
XCMDs 


http://www.csulb.edu/~bcheves/xcmdhideout/xcmdhideout.html 
Jon Wiederspan 
http://www.uwtc.washington.edu/JonWiederspan/JonProjects.html 


Vendors, Products and Miscellaneous 


Aladdin HASP http://www.hasp.com/ 
Alpha (text editor) http:/Awww.cs.umd.edu/~keleher/alpha.htm| 
BBEdit ftp://ftp.netcom.com/pub/bb/bbsw 
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Celestin ftp://ftp.teleport.com/vendors/cci/apprentice 


CIL http:/Awww.cilabs.org/ 

Digitool http:/Awww.digitool.com/ 

Dilbert http:/Awww.unitedmedia.com/comics/dilbert 
Tom Engel 


http://gasnet.med.nyu.edu/demos/Tom's_Macintosh_Page.html 
Erogonomics Web http://tucker.mech.utah.edu/ 
Chris W. Johnson http://gargravarr.cc.utexas.edu 
General Magic http:/Awww.genmagic.com/ 
Graphicla Business Interfaces http://www.gbi.com 
Iconix http:/Awww.biap.com/Iconix/ 
Just Some Guy http://www.spies.com/greg/ 
MIND/MacDNS http://cybercronx.techwood.org 
Macintosh Vendor Directory 

http://rever.nmsu.edu/~elharo/faq/vendor.html 
Mac Netswitch http:/Awww.nd.edu/~dwalton1/ 


MacNosy ftp://ftp.netcom.com/pub/ma/macnosy 
Metrowerks http:/Awww. fairgate.com/cw/cw.html 
Motorola http://www.mot.com/PowerPC 
NeoLogic http:/Awww.neologic.com/~neologic/ 
Newton http://newton.uiowa.edu/ 
PACE http://paceap.com/pace.html 
QKS/Smalltalk http://www.qks.com 
QUED/M ftp://ftp.nisus-soft.com/pub/nisus 

see also http://www.nisus-soft.com/~nisus 


QuickCam _http:/Awww.jungle.com/msattler/sci-tech/comp/hardware/quickcam.html| 
Summit Software http://www.summsoft.com 


Symantec ftp://ftp.symantec.com/macintosh/updaters/devtools 

Tenon http://www.tenon.com/ 

TidBITS newsletter http:/www.dartmouth.edu/pages/TidBITS/TIcBITS.htm| 
see also news://comp.sys.mac.digest 


to subscribe mailto:info@tidbits.com 
Time Tracker http:/Awww.maui.com/~billm/ 
UserLand AutoWeb http:/Awww.hotwired.com/Staff/userland/ 
The Well Connected Mac _http://rever.nmsu.edu/~elharo/faq/Macintosh.htm| 


Macintosh 

The Time Sink Award goes to Robert Lenz’s homepage. 
Robert’s editing is this homepage’s greatest asset — the page is 
selective, not comprehensive, so you feel as if you can read 
everything. It’s updated frequently, and links are kept current. 
http://www.astro.nwu.edu/lentz/mac/programming/home-prog.html 


Chris Tate writes: “I’ve put together, and hope to continue 
developing, a Web page that provides pointers to any and all 
Mac development information available on the Internet. It’s my 
hope that folks will find it a useful place to go when trying to 
track down answers to their problems, documentation on 
various portions of the MacOS, people’s opinions and collected 
wisdom, etc.” http://world.std.com/~ctate/ 


dgr.com features the Mac Net Journal, an online Macintosh end 
user magazine. It’s sponsored by several companies including 
a mail order Macintosh computer store and that store’s “outlet” 
where they sell closeouts. Make them an offer. 
http://www.dgr.com/ 


There are a few new OpenDoc resources on the web. The first 


is a listing of magazine articles and technical information about 
OpenDoc. The second is a catalog of parts, with special areas 
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where you can share, with other programmers, suggestions for 
new parts. 
http://www.acl.lanl.gov/sunrise/DistComp/OpenDoc/overview.html 
http://www.eng.uci.edu/~sroussey/NetVision/software/od_parts/ 


Brendon Cheves maintains a Web page dedicated to learning 
XCMD programming. It’s called the “XCMD Hideout” and 
includes links to Hypercard and XCMD informaton. 
http://www.csulb.edu/~bcheves/xcmdhideout/xcmdhideout.html 


Last month, I neglected to inform everyone that the TCL 
archives accept submissions. Please upload submissions of TCL 
source code to ftp://daemon.ncsa.uiuc.edu/Incoming and then send 
email to tcladmin@uiuc.edu letting them know what you 
uploaded, including a brief description, and information about 
what version of TCL it works with. If you have TCL code, 
consider sharing it with the them. ftp://daemon.ncsa.uiuc.edu/TCL 
http://rhino.harvard.edu/dan/TCLArchive.html 


Internet 

People with disabilities now have a unique place to search for 
services, information and products designed especially for their 
needs: their home computer. Evan Kemp Associates, Inc. has 
introduced the “Disability Mall” on the Internet to offer an 
information and products “crossroads” for consumers with 
disabilities in a way that is practical, extremely convenient and 
economical. http://disability.com 


The WebEdge Conference is the premier conference for CGI 
hackers, web page creators, server programmers, and other 
wireheads. http://www.webedge.com 


SurfWatch is an extension which allows you to prevent users 
from connecting to Internet addresses which are deemed to 
have sexually controversial. This is fascinating “self-censorship” 
technology. http://www.surfwatch.com/ 


RealAudio is yet another Internet company using Apple’s 
function name capitlization conventions. They also have a nifty 
internet audio player, and it works over a 14.4K SLIP 
connection. http://www.realaudio.com 


Yahoo is a friendly Internet resource directory. Here are some 
relevant pages in the directory: 
http://www.yahoo.com/Computers/Operating_Systems/Macintosh_OS/ 
http://www.yahoo.com/Computers/Operating_Systems/Magic_Cap/ 
http://www.yahoo.com/Computers/PCs/Macintosh/ 
http://www.yahoo.com/Computers/PCs/Macintosh/Programming/ 


Thanks this month go to Brendon Cheves, Dan Crevier, David 
Goldman, Paul Robichaux, Steven T. Roussey, Jim Strauss, and 
Christopher Tate, Bob Witeck. Alright, where are the women? 
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E-mail, Fax, write, or call us. You may use your VISA, 
MasterCard or American Express; or you may send check 
or money order (in US funds only): 

MacTech Magazine, P.O. Box 5200, Westlake Village, CA 
91359-5200 

Voice: 805/494-9797 © Fax: 805/494-9798 











If you are an e-mail user, you can place orders or contact 
customer service at: 

e AppleLink: MT.CUSTSVC 

* CompuServe: 71333,1063 

¢ Internet: custservice@xplain.com 

e America Online: MT CUSTSVC 

¢ GEnie: MACTECHMAG 

¢ eWorld: MT.CustSvc 










SUBSCRIPTIONS 
US magazine with source code disk: $124 for 12 issues 
Canadian magazine with source code disk: : $136 for 12 
issues 

International magazine with source code disk: $194 for 
12 issues 










CD-ROM 
MacTech CD-ROM, Volumes 1-10: Includes over 1230 
articles from all 115 issues (1984-1994) of MacTech 
Magazine (formerly MacTutor). All article text and source 
code. Now in THINK Reference format. The CD includes 
Symantec's THINK™ Reference 2.0, working applications 
with full documentation, product demos for developers and 
more. See advertisement, this issue: $99.95. Upgrades 
$39.95. E-mail, call or write for info. 















BOOKS 
The Best of MacTutor, Volume 1: Sold Out 

The Complete MacTutor, Volume 2: Sold Out 

The Essential MacTutor, Volume 3: $19.95 

The Definitive MacTutor, Volume 4: $24.95 

The Best of MacTutor, Volume 5: $34.95 

Best of MacTutor Collection, Volumes 3 — 5: $69 

Best of MacTutor, Volumes 6, 7, 8 & 9: Not available 











DISKS 
Source Code Disks: $8 each 
Topical Index (1984-1991) on disk: $5 








MAGAZINE BACK ISSUES 
Volumes 3, 4, 5, 6, 7, 8,9 and 10: $5 each (subject to 
availability) 







California residents include 8.25% sales tax on all 
software, disks and books. 







Allow up to 2 weeks for standard domestic orders, more time 
for international orders. 












PLEASE NOTE 
Source code disks and journals from MacTech Magazine are 
licensed to the purchaser for private use only and are not to be 
copied for commercial gain. However, the code contained 
therein may be included, if properly acknowledged, in 
commercial products at no additional charge. All prices are 
subject to change without notice. 
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MACTECH EXCLUSIVES 


MacTech Magazine is your exclusive source 
for these specific products: 


Ad Lib 2.0 The premier MacApp 3.0 compatible 
ViewEdit replacement. A powerful user-interface 
editing tool to build views for MacApp 3.0 and 3.1. 
Ad Lib allows subclassing of all of MacApp’s view 
Classes including adorners, behaviors, and drawing 
environments. String and text style resources are 
managed automatically. Alternate display methods, 
Such as a view hierarchy window, allow easy 
examination of complex view structures. Ad Lib 
includes source code for MacApp extensions that are 
supported by the editor — buttons can be activated by 
keystrokes, behaviors can be attached to the 
application object, and general purpose behaviors 
can be configured to perform a number of useful 
functions. Run mode allows the user to try out the 
views as they will work in an application. Templates 
can be created to add additional data fields to view 
Classes. Editing palettes provide fast and easy editing 
of common objects and attributes. Works with ACI’s 
Object Master (version 2.0 and later) to navigate a 
project's user interface source code. $195 


FrameWorks Magazine: $8/back- 
issue, subject to availability. 


FrameWorks Source Code 
Disk: $10/back issue, subject to 
availability. 


NEW!) Five Years of Objects CD-ROM: 
FrameWorks archives and source code 
from April 1991 to January 1993, plus selected object- 
Oriented publicly available software and demos. $95 


MADACON ’93 CD-ROM: The highlights of 
MADACON '93, including Mike Potel on Pink, 
Bedrock, MacApp, OODLs, and more. Slides, 
articles, demos, audio, and QuickTime. $95 


NEW! MAScript 1.2 adds support for 
AppleScript to your MacApp 3.0.1 and 


3.1 based applications. Make your application 
scriptable and recordable by building on a tried and 
tested framework for object model support. MAScript 
dispatches Apple events to the appropriate objects, 
Creates object specifiers, and makes framework 
Objects like windows and documents scriptable and 
recordable. Sample application shows you how to 
begin adding support for scripting and recording. 
MAScript includes complete source code. Install 
MAScript by modifying one MacApp source file, then 
adding another to your project. Future versions of 
MacApp will incorporate MAScript, so MAScript 
support you add now will work in the future. $199 


The Mjsiner BETA System is a software 
development environment supporting object-oriented 
programming in the BETA programming language. 
BETA is uniquely expressive and orthogonal. BETA 
unifies just about every abstraction mechanism — 





including class, procedure, function, coroutine, 
process and exception — into the ultimate abstraction 
mechanism: the pattern. BETA includes: general 
block structure, strong typing, whole/part objects. 
The compiler: binary code generation, automatic 
garbage collection, separate compilation, interface to 
C, Pascal, and assembler. The system: persistent 
Objects, basic libraries with containers classes, 
platform-independent GUI application frameworks on 
Unix, Mac and Windows NT, metaprogramming 
system. The tools available on Unix: the hyper 
structure editor supporting syntax directed editing, 
browsing, etc., and the source code debugger are 
currently being ported to the Macintosh system. The 
Mjglner BETA System for Macintosh requires MPW 
(basic set) 3.2 or later. Package containing compiler, 
basic libraries, persistent store, GUI framework, and 
comprehensive documentation. (Other packages are 
also available) $295 


More Savvy includes all Savvy 
eatures plus Apple Event support for all sub- 
classes of TEventHandler with extensive view support. 
Apple Event support for text includes text attributes 
and sub-range specification. Recordability supports 
additional actions, and coercion includes additional 
types. Additional client and server Apple Events. $450 


| NEW Version! | Savvy 1.1 OSA support 
ncludes —attachability, 
recordability, scriptability, coercion, in addition to 
script execution, idling and i/o. Apple Event support 
includes complex object specifiers, synchronous/ 
asynchronous Apple Event handling, and Apple Event 
transactions for clients and servers. The Core Suite 
of Apple Event objects is supported including the 
application, documents, windows, and files. 
Documentation includes technology overview, 
cookbook, and sample code. $250 Savvy now 
supports MPW 3.1, 3.11 and continues to support 
3.01, as well as supporting Metrowerks CodeWarrior. 
This month only, special offer -— All Savvy 
versions include free copy of Savvy QuickTime! 


NEW! Savvy QuickTime Requires Savvy, 
More Savvy, or Super Savvy. Includes 
QuickTime, Apple Event, and view template support. 
Movies come out of the box ready to play, edit, and 
react to Apple Events. They can be included in any 
view structure, including templates, and are 
displayed in the scrap view. Movie controls include 
volume, play rate, looping mode, display style, and 
other characteristics. $250 


NEW!| Super Savvy includes all More Savvy 


features plus compile, edit, and record 
scripts using built in script editor. View template 
editors, like Ad Lib, can attach scripts to view 
Objects and modified scripts are saved with the 
document. Script action behavior allow quick access 
for executing and editing scripts attached to views. 
Text to object specifier coercion plus more. $700 
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MacTech Magazine is your exclusive source for 
available back issues of SFA’s magazine, source 
code disks and assorted CD’s. Call for more info 
and pricing. 


BOOKS 


Adobe Premiere for Macintosh: 

Classroom in a Book, Second 
Edition by Adobe Press. This is the updated edition of the 
official Adobe training workbook! Covering all the essential 
features of this video editing software, this book/CD-ROM 
Set features twenty tutorial lessons to guide teachers and 
Students through the magic of Macintosh movie-making. 
CD-ROM includes QuickTime movies, electronic images, 
and frames needed for the workshop lessons in the book. 
Detailed yet easy-to — follow steps to creating multimedia 
presentations, animation, and videos. Contains the latest 
information on filters, audio, superimposed clips, advanced 
editing, and more $40-06 $44.95 


America Online For Dummies” by 

John Kaufeld. “Driver's Education” for this 
wildly popular on-line service — covering everything from 
the main menu to the mail groups for Windows, DOS, and 
Mac platforms. Includes a coupon for free usage time on 
AOL for first-time users. $49-09 $17.95 


C For Dummies,” Volume 1 by Dan 

Goodwin. Finally! A hands-on, step-by-step 
tutorial for learning the essentials of programming in C. 
$49-05 $17.95 


NEW! C++ For Dummies” by Stephen R. Davis 
is the all-in-one reference that gets you 
comfortable with object-oriented methods and up and 
running doing C++ programming! $49-95 $17.95 


NEW!) The Complete AppleScript® Hand- 
book by Danny Goodman is a self-contained 
kit to customizing and enhancing the Macintosh 
environment. The disk contains AppleScript 1.1 Runtime, 
Chang Labs TableServer, and useful, ready-to-run scripts. It 
also shows the Mac user how to automate many processes 
—no programming experience necessary. $36-00 $31.50 


NEW! The Complete HyperCard® 2.2 
Handbook Fourth Edition by Danny 
Goodman is the biggest-selling Mac book — new revised 
and updated for version 2.2. It shows how to build working 
applications using the latest version of HyperCard and 
covers text, painting tools, extension commands (XCMDs), 
scripting in HyperTalk, and more. $36-08 $31.50 


NEW! CompuServe For Dummies” by 
Wallace Wang Find out how to shop, play 
games, join forums, get the latest news, do research, and 
more on this popular on-line service. $40-05 $17.95 


NEW! The Computer Privacy Handbook is 
A Practical Guide To E-Mail Encryption, Data 
Protection, and PGP Privacy Software. With millions of e- 
mail messages and on-line discussions exchanged daily 
on the Internet, electronic security has become a key 
concern. The Computer Privacy Handbook explains 
practical steps individuals can take to safeguard their 
electronic security. It also gives a vivid description of 
how the "Surveillance Age" threatens each person's 
personal security, a non-technical introduction into data 
encryption, and the U.S. Government's Clipper Chip 
Surveillance proposal. It also provides an overview of 
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PGP, (Pretty Good Privacy), the world standard for e-mail 
privacy. $24.06 $22.45. 


NEW! Danny Goodman’s AppleScript Hand- 

book Second Edition by Danny Goodman is a 
self-contained kit shows the reader how to customize and 
extend the capabilities of any Macintosh computer — no 
programming experience needed! This enhanced and 
expanded edition of The Complete AppleScript Handbook 
focuses on putting AppleScript to work in all sorts of 
practical situations. In addition, Danny Goodman's 
AppleScript Handbook, Second Edition shows you how to 
apply the same principles to other popular scripting. systems, 
such as UserLand Frontier and QuicKeys. Shows readers 
how to use scripts to enhance the Macintosh environment, 
automate many processes, link data between applications, 
and much more. This book provides a wealth of all-new 
examples showing how to integrate AppleScript with the 
Finder, spreadsheets, desktop publishing programs, 
graphics applications, databases, telecommunications 
programs, utilities, and HyperCard. The accompanying 3 
1/2" disk is jam-packed with over $100 worth of software, 
including AppleScript 1.1, valuable utilities, and powerful, 
ready-to-use scripts. s, $30.00 $35.00 


NEW! Danny Goodman’s Macintosh® Hand- 
book Featuring System 7 by Danny 
Goodman with Richard Saul Wurman. This user friendly 
design includes a unique four-color design and exploded 
diagrams. It includes over 100 spreads break down and clarify 
Mac problems and includes insider's tips. $20-06 $26.95 


Dan Shafer Presents the Power of 

Prograph CPX is a hands-on, project- 
centered approach to learning the most revolutionary 
object-oriented programming language on the planet. 
The language Kurt Schmucker likes best. The language 
that programmers actually report having “fun” 
programming. This 550-page book takes you step by 
step through three interrelated projects of increasing 
complexity. Along the way you'll learn the underlying 
Prograph language, how to use the power of lists, and the 
important aspects of the CPX classes and object editors. 
Includes disk with all code in the book. $49-05 $44.95 


The Elements of E-Mail Style by Brent Heslop 
and David Angell. Learn the rules of the road in the e-mail 
age. Concise, easy-to-use format explaining essential e- 
mail guidelines and rules. It covers style, tone, 
typography, formatting, politics and etiquette. It also 
outlines basic rules of composition within the special 
context of writing e-mail and includes samples and 
templates for writing specific types of e-mail 
correspondence. 208 pages. $4495 $13.45 


E-Mail Essentials by Ed Tite! & Margaret Robbins is 
a hands-on guide to the basics of e-mail, the ubiquitous 
networks communication system. The book is suitable for 
both the casual e-mailer and the networking professional, 
as it covers everything from the installation of e-mail to the 
maintenance and management of e-mail hubs and 
message servers. The books explains the fundamental 
concepts and technologies of electronic mail, featuring 
chapters on Lotus applications and CompuServe, as well 
as information on upgrading, automation, message-based 
applications, and user training. E-mail Essentials is a step- 
by-step, jargon-free guide that will enable the e-mail user 
to get the most out of the communication potentials of 
networking. 250 pp. $2495 $22.45 


eeWorld: The Official Guide for 
Macintosh Users by Cary Lu & John 


Milligan. Discover the next generation of online services 
— Apple’s eWorld. Certain to be a bestseller, this 
authorized guide to contains the exclusive Apple software 
needed to connect to eWorld. It also provides a road map 
of eWorld and all of its features, and is the first and best 
book on this exciting new service. Covers every aspect of 
eWorld, the next generation of online services. Everything 
users need to get connected and get the most out of 
eWorld. The only official Apple book and software for 
accessing eWorld $29-06 $26.95 


NEW! Graphic Gems V Edited by Alan W. Paeth 

is Graphic Gems V is the newest volume in The 
Graphic Gems Series. It is intended to provide the graphics 
community with a set of practical tools for implementing 
new ideas and techniques, and to offer working solutions to 
real programming problems. These tools are written by a 
wide variety of graphics programmers from industry, 
academia, and research. The books in this series have 
become essential, time-saving tools for many 
programmers. It is the latest collection of graphics tips in 
The Graphic Gems Series written by the leading 
programmers in the field. It contains about 50 new gems 
displaying the most recent and innovative techniques in 
graphics programming. Also included is new gems in 
ellipses, splines, Bezier curves, and ray tracing. Includes a 
disk which contains source code from all five volumes and 
is available in both IBM and Macintosh versions. 
CONTENTS: Algebra and Arithmetic. Computational 
Geometry. Modeling and Transformation. Curves and 
Surfaces. Ray Tracing and Radiosity. Halftoning and Image 
Processing. Utilities. $49-05 $44.95 


NEW! Guide to Macintosh System 7.5 by 
Don Crabb. Written by an industry expert, this 
is the first thorough book on the new and improved 
Macintosh operating system. Readers will learn all the 
highlights of the new System, including how to work 
efficiently with applications. ntuitive, task-oriented 
approach teaches topics the way users think, not the way 
the machine thinks. Covers all the new features of System 
7.5, including PowerTalk, PC Exchange, and MacTCP. 
Written by a world-renowned Mac expert $26-00 
$22.50 


How To Write Macintosh Software by Scott 
Knaster is a great source for understanding Macintosh 
programming techniques. Drawing from his years of 
experience working with programmers, Scott explains the 
mysteries and myths of Macintosh programming with wit 
and humor. The third edition, fully revised and updated, 
covers System 7 and 32-bit developments, and explores 
such topics as how and where things are stored in 
memory; what things in memory can be moved around 
and when they may be moved; how to debug your 
applications with MacsBug; how to examine your 
program's code to learn precisely what's going on when it 
runs. 448 pgs. $28-95 $26.05 


NEW! | HyperTalk® 2.2: The Book Second 
Edition by Dan Winkler, Scott Kamins, and 
Jeanne DeVoto is the most complete, authoritative source 
on HyperTalk 2.2 programming and troubleshooting. It 
covers each language element of HyperTalk 2.2 (including 
the odd quirk or bug). $36-08 $31.50 


The Instant Internet Guide by Brent Heslop and 
David Angell. An Internet jump-start — how to access, use 
and navigate global networks. The Instant Internet Guide 
equips readers with the tools needed to travel the electronic 
world. The book highlights the most important sources of 
Internet news and information and explains how to access 
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information on remote systems. It outlines how to use 
essential Internet utilities and programs and includes a 
primer on UNIX for the Internet. 224 pages $4405 $13.45 


NEW! The Internet by Paul Hoffman gives the 

Straight scoop on the Net with the elegant, 
entertaining 4-color companion to the PBS special “The 
Internet Show.” Color photos and illustrations explain 
Internet key features, its history, and trivia. Covers the 
basics and also a multitude of Internet Information Services 
and extensive lists of Internet sites. $2499 $22.50 


NEW! | The Internet, Deluxe Edition by 
Paul Hoffman. All of the brilliance of The 
Internet plus the hot NetManage Internet Chameleon 
software! This bundled Deluxe Edition includes 
everything you need to surf the Net! Fully automated, 
NetManage has put together 3 disks filled with Internet 
tools, service providers, applications, and more — an 
unbelievable value! $34-99 $31.50 


The Internet For Macs For Dummies” 

by Charles Seiter. Now novice Mac users have 
an Internet guide written especially for them — in the easy 
..For Dummies™ style they love. $49-99 $17.95 


The Internet For Dummies” 2nd 
Edition by John Levine and Carol Baroudi. 
Surf the net with ease using the up-to-the-minute new 
edition of the #1 bestselling Internet gue — now with 
friendly help on connecting to the Internet. $40-09 $17.99 


The Internet For Dummies” Quick 

Reference by John Levine. This fact-filled 
quick reference provides plain English explanations of 
Internet terms and basics. Cross-referenced to The 
Internet For Dummies. $8-95 $8.05 


The Internet For Macs For Dummies” 

Starter Kit by Charles Seiter. Access and 
navigate the Net like a pro the fun and easy way with this all- 
inclusive Starter Kit for Mac users. Kit includes a special edition 
of the bestselling The Internet For Macs For Dummies™, plus 
two disks featuring The Pipeline and TCP/Connect Il® 
Extended software with: E-Mail, UseNet News Reader, FTP, 
Telnet, Gopher, and more! $290-99 $26.99 


NEW! The 1994 Internet White Pages by 

Seth Godin & James S. McBride is the one and 
only complete alphabetical directory of people on the 
Internet. $29-06 $26.95 


NEW! Internet Power Tools by John Ross is 
designed for intermediate PC users, Internet 
Power Tools is a complete book/disk package that allows 
access to the world’s largest network — the Internet — with 
the same ease as one uses Windows. The detailed 
instructions allow readers to find their way around the 
Internet fast and covers e-mail, file transfers, remote logon, 
on-line directories, and more. The accompanying disk is 
packed with powerful utilities, including Cello, PC Eudora, 
and Panda — easy-to-use graphical user interfaces (GUI) 
that obviate the need for the obscure Unix line commands 
that everyone else must learn. It also provides access to 
even more software via Random House’s Internet FTP site 
and shows how to connect to the Internet via a network 
connection or dial-in. $46-60 $36.00 


NEW! Internet SECRETS by John Levine & 
Carol Baroudi gives the most from the Net with 
this performance-oriented book — for Windows, UNIX, DOS, 
and Mac Internet users who know how to get connected but 
want to optimize their connections. $39-99 $35.99 


Learn C on the Macintosh by Dave Mark. This 
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self-teaching book/disk package gives you everything you 
need to begin programming on the Macintosh. Learn to 
write, edit, compile, and run your first C programs 
through a series of over 25 projects that build on one 
another. The book comes with THIN C — a customized 
version of Symantec’s THINK C, the leading programming 
environment for Macintosh. 464 pages, Book/disk: 
$3495 $31.45 


Learn C++ on the Macintosh by Dave Mark. After 
a brief refresher course in C, Learn C++ introduces the 
basic syntax of C++ and object programming. Then you'll 
learn how to write, edit, and compile your first C++ 
programs through a series of programming projects that 
build on one another as new concepts are introduced. Key 
C++ concepts such as derived classes, operator 
overloading, and iostream functions are all covered in 
Dave's easy-to-follow approach. Includes a special version 
of Symantec C++ for Macintosh. Book/disk package with 
3.5" 800K Macintosh disk. 400 pages, $36-95 $33.26 


Macintosh C Programming Primer Volume I, 
Second Edition, Inside the Toolbox Using 
THINK € by Dave Mark and Cartwright Reed. This new 
edition of this Macintosh programming bestseller is updated 
to include recent changes in Macintosh technology, 
including System 7, new versions of THINK C and ResEdit, 
and new Macintosh machines. Readers will learn how to use 
the resources, Macintosh Toolbox and interface to create 
stand-alone applications. 672 pages, $26-05 $24.25 


Macintosh € Programming Primer Volume 
ll, Mastering the Toolbox Using THINK C by 
Dave Mark. Volume I! picks up where Volume | leaves off, 
covering more advanced topics such as: Color 
QuickDraw, THINK Class Library, TextEdit, and the 
Memory Manager: 528 pgs. $26-05 $24.25 


Macintosh® Crash Course by Glenn 

Brown shows Macintosh power users what to 
do when things go wrong with their system. Macintosh 
Crash Course shows readers how to overcome Macintosh 
system crashes, system lock-ups, and various, frustrating 
and cryptic error messages they regularly encounter. It 
includes a CD-ROM with shareware and freeware to help 
the user diagnose and repair system failures. Includes up- 
to date coverage through Macintosh System 7.5, Managing 
memory, Hardware diagnostics, File recovery, PowerBook 
problems, PowerPC problems, network utilities, hard drive 
repair utilities, SCS! problems, conflicts and solutions and 
File synchronization and utilities. $29-95 $26.95 


Macintosh Pascal Programming Primer 
Volume I, Inside the Toolbox Using THINK 
Pascal by Dave Mark and Cartwright Reed. This tutorial 
shows programmers new to the Macintosh how to use the 
Toolbox, resources, and the Macintosh interface to create 
stand-alone applications with Symantec’s THINK Pascal. 
544 pages $26-05 $24.25 


Macintosh Programming Techniques by Dan 
Sydow (Series Editor: Tony Meadow). This tutorial and 
handbook provides a thorough foundation in the special 
techniques of Macintosh programming for experienced 
Macintosh programmers as well as those making the 
transition from DOS, Windows, VAX or UNIX. Emphasizes 
programming techniques over syntax for better code, 
regardless of language. Guides the reader through Macintosh 
memory management, QuickDraw, events and more, using 
sample program in C++. Disk includes an interactive tutorial, 
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plus reusable C++ code. $8495 $31.95 


NEW! Mac Programming for Dummies” by 
a Parks Sydow takes the intimidation and 
f writing Mac programs. $49-06 $17.95 


Mac Screamer The Ultimate 

Macintosh® Supercharging Kit by Jan 
Harrington covers 30 Macintosh models, including the 
Classics, LCs, PowerBooks, and Quadras and gives 
software solutions and hardware tips to accelerate Mac 
performance. It lets readers in on do-it-yourself tips that can 
save them over 25% on upgrade costs. $8609 $31.50 


NEW! Macworld Ultimate Mac Program- 
ming by Dave Mark Bestselling Mac 
programming author Dave Mark reveals the secrets of 
Mac programming and presents important, timesaving 
techniques. $39-06 $35.95 


NEW! Metrowerks CodeWarrior Prog- 
ramming by Dan Parks Sydow. Includes 
CodeWarrior Lite, and Full Coverage of PowerPlant™. The 
best information on Metrowerks CodeWarrior 6, giving 
full coverage to the Gold Edition. Even if you don't already 
own CodeWarrior 6, you'll still be able to work with the 
examples in this book, oe the CodeWarrior 6 Lite CD 
that comes with it. $80-06 $35.95 


MORE jatariet For Dummies” by 

John Levine & Margaret Levine Young. The 
expanded guide full of great Internet tips for all those 
users who want to know where to go and what to do once 
connected. $49-95 $17.95 


Mosaic For Dummies; Windows 

Edition by David Angell & Brent Helsop. 
Learn to use Mosaic with the only book that explains the 
most popular viewer of the World Wide Web in plain 
English. Covers the popular Windows version of Mosaic. 
$40-09 $17.99 


Multimedia Authoring: Building and 
Developing Documents by Scott Fisher addresses 
the concerns that face anyone trying to create multimedia 
documents. It offers specific advice on when to use 
different kinds of information architecture, discusses the 
human-factors concepts that determine how readers use 
and retain information, and them applies these findings to 
multimedia documents, covering the high-level issues 
concerning planners and authors of multimedia 
documents as well as those involved in evaluating or 
purchasing multimedia platforms. Includes one 3.5" high- 
density disk. $8496 $31.45 


Multimedia Starter Kit for Macin- 

tosh by Michael D. Murie. This hands-on 
book offers the latest and greatest in multimedia for the 
Mac! Readers learn how to design their own multimedia 
projects step by step, then try it themselves with the 
demos, graphics, clips, and sample projects on the CD- 
ROM! CD-ROM contains QuickTime, sound and graphics 
Clips and utilities, sample projects, and more. How to 
choose and use a variety of Macintosh multimedia tools 
and presentation environments. Includes demos of Adobe 
Illustrator, Premiere, Heizer Software programs, and more 
$30.00 $27.00 


NEW! | Net Chat” by Michael Wolff & Co. There are 
an estimated 35 million people online and 
most of them spend time chatting on the Net. Net Chat is the 
first comprehensive, discriminating guide devoted to the 
vast world of online interpersonal communications. 
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Following the successful format of the ever popular Net 
Guide, Net Chat is designed for easy access, featuring an 
attractive layout, informative illustrations, and thousands of 
choices. It is encyclopedic in scope — covers “chat” groups 
on the Internet, all the major commercial services (including 
CompuServe, Prodigy, and America Online), and hundreds 
of bulletin boards. It features a map of salons and meeting 
places in Cyberspace, where people stop to chat about 
politics, lifestyle, music, dating, sex, fantasy, health, family, 
and just about everything imaginable! The entries include 
one- and two-page spreads that describe the featured topic, 
and provide easy-access instructions, complete listings, and 
visual images from the Net. For use with all computer 
platforms — PCs, Macs, workstations. $49:00 $17.00 


NEW! Optimizing PowerPC Code: Prog- 
ramming the PowerPC in Assembly 
Language 1o take full advantage of the potential of the 
PowerPC, Developers need to master the Assembly 


Language techniques. This book shows how to use the. 


Assembly Language in PowerPC Programs to produce 
faster more robust software. $89-05 $35.95 


PowerBook” The Digital Nomad’s 
Guide by Andrew Gore and Mitch Ratcliffe. 
$24.00 $21.60 


NEW! Power Macintosh Programming 
Starter Kit by Tom Thompson. This is the 
first tutorial/reference for programmers who want to enter 
the new world of the PowerPC chips. Users find all the 
details on the new microprocessors, the new RISC 
architecture, and how to write native code and emulation 
operations to create their own software for the Macintosh 
PowerPC. CD-ROM includes a unique compiler for 
writing code easily. The all-in-one book that gets 
programmers the information and tools they need. 
Programming examples reinforce explanations of code 
and programming tools $8809 $35.10 


Programming for System 7 by Gary Little and Tim 
Swihart, is a hands-on guide to creating applications for 
System 7. It describes the new features and functions of 
the operating system in detail. Topics covered include file 
operations, cooperative multitasking, Balloon Help, Apple 
events, and the File Manager. Numerous working C code 
examples show programmers how to take advantage of 
each of these features and use them in developing their 
applications. 384 pages. $26-06 $24.25 


Programming for the Newton Software 
Development with NewtonScript by Julie 
McKeehan and Neil Rhodes. Foreword by Walter R. 
Smith. Programming for the Newton: Software 
Development with NewtonScript is an indispensable tool 
for Newton programmers. Readers will learn how to 
develop software for the Newton on the Macintosh from 
people that developed the course on programming the 
Newton for Apple Computer. The enclosed 3.5" disk 
contains a sample Newton application from the books, as 
well as demonstration version of Newton Toolkit (NTK), 
Apple Computers complete development environment for 
the Newtons. A Publication of AP Professional May 1994, 
Paperback, 393 pp. $20-06 $26.95 


Programming in Symantec C++ for the 
Macintosh by Judy May and John Whittle. This book 
will introduce you to object-oriented programming, the C++ 
language, and of course Symantec C++ for the Macintosh. 
You don't have to be a programmer, or even know anything 
about programming to benefit from this book. Programming 
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in Symantec C++ for the Macintosh covers everything from 
the basics to advanced features of Symantec C++. If you are 
a Think C or Zortech C++ programmer who wants to learn 
more about object-oriented programming or what's different 
about Symantec C++, there are chapters specifically for you. 
Includes helpful examples of C++ code that illustrate object- 
oriented programs. $20-05 $26.95 


NEW! Programming Primer For The Macin- 

tosh® Volume 1 by John Whittle and Judy 
May. This book provides an introduction to Macintosh 
programming, using C++ as the example language, and 
provides realistic, easy to follow, programming examples 
designed to work with either Symantec® C++ or 
Metrowerks® CodeWarrior 6". Also includes one 3.5" disk 
with source code for the programming examples, along 
with numerous, useful, public domain utilities to use with 
each compiler. $3406 $34.15 


NEW! QuickTime Starter Kit for Macin- 

tosh by Robert A. Lettieri & Judith Stern. This 
is the ultimate package for getting productive and having 
fun with Macintosh movie-making. Easy steps and 
valuable software help readers play, make, and edit 
QuickTime movies. CD-ROM includes QuickTime tools, 
movie clips, shareware, and demos of Premiere and other 
programs. Written by members of the respected Berkeley 
Macintosh User Group. Tips on the best ways to bring live- 
action video to Mac multimedia $46-08 $40.50 


NEW! Real World Apple Guide, For The Mac 
is the much anticipated help and navigational 
aid component of the new Apple System 7.5 OS. The book 
is a practical introduction to Apple Guide for 
programmers. It explains the design and function of Apple 
Guide, how to design your own guides using Apple 
Script. Comes with a disk of sample Apple Guides for 
Apple Guide-compliant applications. $389-06 $35.95. 


NEW! The ResEdit All Night Diner by David 

Ciskowski. An idea-filled menu and 
introduction to the joys of customizing software — and 
adding personality to the Mac with ResEdit! Shows readers 
how to customize default icons, the text of menus and 
dialog boxes, cursors, pointers, and more. Provides 
specific recipes for doing creative things with ResEdit — 
plus how to avoid problems. Disk features ResEdit 
program, plus lots of sample resources $2406 $22.45 


ResEdit™ Complete, Second Edition by Peter 
Alley and Carolyn Strange. With ResEdit, Macintosh 
programmers can customize every aspect of their interface 
form creating screen backgrounds and icons to 
customizing menus and dialog boxes. 608 pages. 
Book/disk package. $8495 $31.45 


Sad Macs, Bombs, Disasters and What to Do 
About Them by Ted Landau comes to the rescue with your 
Macintosh problems. From fractious fonts to the ominous 
Sad Macintosh icon, this emergency handbook covers the 
whole range of Macintosh problems: symptoms, causes, and 
what you can do to solve them. 640 Pages. $24-96 $22.45 


Software By Design: Creating User Friendly 
Software by Penny Bauersfeld (Series Editor: Tony 
Meadow). This excellent reference provides readers with a 
thorough how-to for designing software that is easy to 
learn, comfortable to operate and that inspires user 
confidence. Written from the perspective of Macintosh, 
but compatible with all platforms. Stresses user input 
from initial design, through prototyping, testing and 
revision. Provides tools for analyzing user needs and test 
responses. Includes exercises for sharpening user- 


oriented design skills. $20-06 $26.95 


NEW! Symantec C++ Programming for the 
Macintosh, Second Edition by Neil 
Rhodes & Julie McKeehan is the perfect introduction to 
C++ programming — the most popular programming 
language for the Mac! This updated edition is the easiest 
way to learn C++ in the Think environment, using many 
examples and hands-on coding experience. The official 
Symantec book, developed in cooperation with the 
Product Development staff. Provides valuable solutions, 
information, and advice for MPW programmers who are 
migrating to the Think environment. Disk includes source 
code from the book and example applications $46-00 
$40.50 


Taligent’s Guide to Designing Programs: 
Well-Mannered Object-Oriented Design in 
C++ is the Taligent approach to object-oriented design. 
The Taligent Operating Environment is the first 
commercial software system based entirely on object- 
oriented technology. Taligent’s Guide to Designing 
Programs is a developer’s-eye view of this system. It 
introduces new concepts of programming and empowers 
developers to create software more productively. Out of 
their direct experience in developing the system, the 
authors focus on global issues of object-oriented design 
and writing C++ programs, and the specific issues of 
programming in the Taligent Operating Environment. 
Taligent’s Guide to Designing Programs assumes the 
reader is an experienced C++ programmer, and proceeds 
from there to fully explore “the Taligent way” of 
programming. 49-60 $17.55 


NEW! The Tao of AppleScript: BMUG’s 
Guide to Macintosh Scripting, 
Second Edition by Derrick Schneider & Hans 
Hansen. This updated bestseller is a complete, natural 
introduction to AppleScript programming essentials. 
Readers learn how to customize applications, automate 
tedious tasks, and create programs without having to use 
a complex programming language. 2 disks contain 
AppleScript, QuickTime, Stufflt Lite, ResMover, and other 
helpful utilities. Progressive structure meets the needs of 
any Mac user, regardless of experience. Professional 
instructions are mixed with practical examples for easy 
learning $29-95 $26.95 


NEW! Teach Yourself Mac C++ Program- 
ming in 21 Days by Namir Clement 
Shammas is the easy-to-follow 21-day format teaches 
readers how to program in C++ using the Symantec C++ 
compiler. It also shows readers how to develop GUI 
applications using the latest version of the THINK Class 
Library (TCL). Targets Symantec C++ 7.0, one of the 
hottest programming languages and development 
environments. Discusses the basics of programming for 
the Mac using TCL and the Visual Architect utility. Uses 
notes, tips, and warnings, as well as Q&A, Quiz, Exercise, 
and Do/Don't sections to teach users the C++ 
programming language. $29-09 $26.99 


3-D Starter Kit for Macintosh by Sean 

Wagstaff. The complete reference to 3-D 
graphics on the Macintosh — ideal for beginning to 
intermediate product designers, illustrators, graphic 
designers, multimedia developers, animators, and video 
producers, aS well as architects and engineers! Covers 
more than 50 major Macintosh 3-D imaging software 
packages — the most comprehensive book available. Lots 
of idea-packed examples that illustrate how 3-D products 
work — individually and together. CD-ROM includes 
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sample models, image galleries, backgrounds, and 
textures, plus 3-D software tryout versions $40-00 
$36.00 


Wireless For The Newton Software 

Development for Mobile Communi- 
cations by Julie McKeehan and Neil Rhodes is a book 
that picks up where Programming for the Newton left off, 
teaching the reader how to develop Newton® software on 
the Macintosh. The enclosed floppy disk provides a 
sample application, as well as a fully functional 
demonstration version of Newton Toolkit" (NTK"), Apple 
Computer's complete development environment for the 
Newton®. Gives hands-on Newton environment training 
with sample code created specifically for the Newton®. 
The authors are external faculty at Apple Developer 
University teaching classes on programming for the 
Newton®. Programming experience is assumed, although 
not in any particular language. Enclosed is a floppy disk 
which contains source code for a Newton application, as 
well as demonstration NTK™. $8405 $31.45 


Writing Localizable Software for the Macintosh 
by Daniel R. Carter. 469 pages. $26-98 $24.25 


THE APPLE LIBRARY 


NEW! AppleScript Finder Guide, English 
Dialect, by Apple Computer. $49-96 $17.95. 


NEW! AppleScript Language Guide, by 
Apple Computer. $29-95 $26.95. 


NEW! AppleScript Scripting Additions 
Guide, by Apple Computer. $48-95 $17.05. 


HyperCard Stack Design Guidelines by Apple 
Computer, Inc. is an essential book for everyone who 
creates Apple HyperCard stacks, from beginners to 
commercial developers. It covers the basic principles of 
design that, when incorporated, make HyperCard stacks 
effective and usable. Topics include guidelines, 
navigation, graphic design and screen illustration, text in 
stacks, music and sound, a sample stack development 
scenario, collaborative development, and the Stack 
Design Checklist. 240 pages. $2496 $19.95 


Inside AppleTalk by Gursharan S. Sidhu, Richard F. 
Andrews and Alan B. Oppenheimer. Apple Computer, Inc. 
650 pages. $3495 $31.45 


Inside Macintosh: AOCE Application 
Interfaces by Apple Computer, Inc. shows how your 
application can take advantage of the system software 
features provided by PowerTalk system software and the 
PowerShare collaboration servers. Nearly every Macintosh 
application program can benefit from the addition of some 
of these features. This book shows how you can add 
electronic mail capabilities to your application, write a 
messaging application or agent, store information in and 
retrieve information from PowerShare and other AOCE 
catalogs, add catalog-browsing and find-in-catalog 
capabilities to your application, write templates that extend 
the Finder's ability to display information in PowerShare 
and other AOCE catalogs, add digital signatures to files or 
to any portion of a document, and establish an 
authenticated messaging connection. $40-46 $36.40 


Inside Macintosh: AOCE Service Access 
Modules by Apple Computer, Inc. describes how to write 
a Software module that gives users and PowerTalk-enabled 
applications access to a new or existing mail and 
messaging service or catalog service. This book shows 
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how to write a catalog service access module (CSAM), a 
messaging service access module (MSAM), and AOCE 
templates that allow a user to set up a CSAM or MSAM and 
add addresses to mail and messages. $26-06 $24.25 


Inside Macintosh: CD-ROM by Apple 

Computer, Inc. Inside Macintosh® is the 
essential reference for programmers, designers, and 
engineers for creating applications for the Macintosh 
family of computers. Inside Macintosh CD-ROM collects 
more than 25 volumes in electronic form, including: 
QuickDraw™ GX Library, Macintosh Human Interface 
Guidelines, PowerPC System Software, Macintosh 
Toolbox Essentials and More Macintosh Toolbox, 
QuickTime and QuickTime Components. Now 
programmers will be able to access over 16,000 pages of 
the information they need directly from their computers. 
Hypertext linking and extensive cross referencing across 
volumes allows programmers to search and explore this 
library in ways that are unique to the electronic medium. 
Every Macintosh programmer will regard Inside Macintosh 
CD-ROM as their most important resource. $99.95 


Inside Macintosh: Devices by Apple Computer, 
Inc. describes how to write software that interacts with 
built-in and peripheral hardware devices. With this book, 
youll learn how to write and install your own device 
drivers, desk accessories, and Chooser extensions; 
communicate with device drivers using the Device 
Manager; access expansion cards using the Slot Manager; 
control SCSI devices using SCS! Manager 4.3 or the 
original SCSI Manager; communicate directly with Apple 
Desktop Bus devices; interact with the Power Manager in 
battery-powered Macintosh computers; and communicate 
with serial devices using the Serial Driver. $29-96 $26.95 


Inside Macintosh: Files by Apple Computer, Inc. 
describes the parts of the operating system that allow you 
to manage files. It shows how your application can handle 
the commands typically found in a File menu. It also 
provides a reference to the File and Alias Managers, the 
Disk Initialization and Standard File Packages. 510 pgs. 
$20-08 $26.95 


Inside Macintosh: Imaging by Apple Computer, 
Inc. covers QuickDraw and Color QuickDraw. The book 
includes general discussions of drawing and working with 
color. It describes the structures that hold images and 
image information, and the routines that manipulate them. 
It also covers the Palette, Color, and Printing Managers, 
and the Color Picker, Color Matching, and Picture 
Utilities. $26-08 $24.25 


Inside Macintosh: Interapplication Com- 
munication by Apple Computer, Inc. shows how 
applications can work together. How your application can 
share data, request information or services, allow the user 
to automate tasks, communicate with remote databases. 


$34.05 $31.45 


Inside Macintosh: Macintosh Toolbox 
Essentials by Apple Computer, Inc. covers the heart of 
the Macintosh. The toolbox enables programmers to 
create applications consistent with the Macintosh “look 
and feel”. This book describes Toolbox routines and 
shows how to implement essential user interface 
elements, such as menus, windows, scroll bars, icons and 
dialog boxes. 880 pages. $34.06 $31.45 


Inside Macintosh: Memory by Apple Computer, 
Inc. describes the parts of the Macintosh operating 
system that allow you to manage memory. It provides 
detailed strategies for allocating and releasing memory, 
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avoiding low-memory situations, reference to the Memory 
Manager, the Virtual Memory Manager, and memory- 
related utilities. 296 pages. $24-95 $22.45 


Inside Macintosh: More Macintosh Toolbox 
by Apple Computer, Inc. covers other Macintosh features 
such as how to support copy and paste, provide Balloon 
Help, play and record sound and create control panels are 
covered in this volume. The managers discussed include 
Help, List, Resource, Scrap and Sound. $3466 $31.45 


Inside Macintosh: Networking by Apple 
Computer, Inc. describes how to write software that uses 
AppleTalk networking protocols. It describes the 
components and organization of AppleTalk and how to 
select an AppleTalk protocol. It provides the complete 
application interfaces to all AppleTalk protocols, including 
ATP (AppleTalk Transaction Protocol), DDP (Datagram 
Delivery Protocol), and ADSP (AppleTalk Data Stream 
Protocol), among others. $29-06 $26.95 


Inside Macintosh: Operating System Utilities 
by Apple Computer, Inc. describes parts of the Macintosh 
Operating System that allow you to manage various low- 
level aspects of the operating system. Everyone who 
programs the Macintosh should read this book! It will show 
you in detail how to get information about the operating 
system, manage operating system queues, handle dates and 
times, control the settings of the parameter RAM, 
manipulate the trap dispatch table, and receive and respond 
to low-level system errors. $26-05 $23.45 


Inside Macintosh: Overview by Apple Computer, 
Inc. is the first book that people who are unfamiliar with 
Macintosh programming should read. It gives an overview 
of Macintosh programming fundamentals and a road map 
to the New Inside Macintosh library. Inside Macintosh: 
Overview also covers various programming tools and 
languages, compatibility guidelines and an overview of 
considerations for worldwide development. 176 pages. 
$2295 $20.65 


Inside Macintosh: PowerPC Numerics by 
Apple Computer, Inc. describes the floating-point 
numerics environment provided with the first release of 
PowerPC processor-based Macintosh computers. The 
numerics environment conforms to the IEEE standard 754 
for binary floating-point arithmetic. This book provides a 
description of that standard and shows how RISC 
Numerics compiles with it. This book also shows 
programmers how to create floating-point values and how 
to perform operations on floating-point values in high- 
level languages such as C and in PowerPC assembly 
language. $28-96 $26.00 


Inside Macintosh: PowerPC System 
Software by Apple Computer, Inc. describes the new 
process execution environment and system software 
services provided with the first version of the system 
software for Macintosh on PowerPC computers. It 
contains information you need to know to write 
applications and other software that can run on the 
PowerPC. PowerPC System Software shows in detail how 
to make your software compatible with the new run-time 
environment provided on PowerPC-based Macintosh 
computers. It also provides a complete technical reference 
for the Mixed Mode Manager, the Code Fragment 
Manager, and the Exception Manager. $2405 $22.45 


Inside Macintosh: Processes by Apple 
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Computer, Inc. describes the parts of the Macintosh 
operating system that allow you to control the execution 
of processes and interrupt tasks. It shows in detail how 
you can use the Process Manager to get information 
about processes loaded in memory. It is also a reference 
for the Vertical Retrace, Time, Notification, Deferred Task, 
and Shutdown Managers. 208 pages. $2205 $20.65 


Inside Macintosh: QuickDraw GX Graphics by 
Apple Computer, Inc. shows readers how to create and 
manipulate the fundamental geometric shapes of QuickDraw 
GX to generate a vast range of graphic entities. It also 
demonstrates how to work with bitmaps and pictures, and 
specialized QuickDraw GX graphic shapes. $26-06 $24.25 


Inside Macintosh®: QuickDraw" 

GX Environment and Utilities A 
companion to QuickDraw™ GX Objects, this book contains 
programming information useful to any developer writing 
QuickDraw GX applications. It describes QuickDraw GX 
memory management, error handling, debugging, and 
mathematical functions, as well as conversion from 
QuickDraw to QuickDraw GX. $29-05 $26.95 


Inside Macintosh: QuickDraw™ GX Library by 
Apple Computer, Inc. is the powerful new graphics 
architecture for the Macintosh. Far more than just a 
revision of QuickDraw, QuickDraw GX is a unified 
approach to graphics and typography that gives 
programmers unprecedented flexibility and power in 
drawing and printing all kinds of shapes, images, and text. 


Inside Macintosh: QuickDraw GX Objects by 
Apple Computer, Inc. introduces QuickDraw GX and its 
object structure, and shows programmers how to manipulate 
objects in all types of programs. $26-98 $24.25 


Inside Macintosh®: QuickDraw” 

GX Printing This book is essential for any 
developer whose QuickDraw™ GX application supports 
printing. It shows how to support the new printing 
features of QuickDraw GX, including desktop printers and 
expandable printing dialog boxes. QuickDraw GX Printing 
also shows how to use printing-related objects to add 
custom panels to printing dialog boxes and to create 
custom page formats. $26-96 $24.25 


Inside Macintosh®: QuickDraw" 

GX Printing Extensions and Drivers 
Any developer who wants to create extensions to the 
application printing capabilities of QuickDraw™ GX, or 
who needs to write a printing device driver that works with 
QuickDraw GX needs this book. QuickDraw GX Printing 
Extensions and Drivers describes how to create printing 
extensions and printer drivers, and provides a complete 
reference to the messages, functions, and resources that 
they use. $29-05 $26.95 


Inside Macintosh®: QuickDraw” GX 

Programmer’s Overview This book 
provides an introduction to QuickDraw™ GX, providing an 
overview of the QuickDraw GX environment from a 
developer's perspective. It introduces the QuickDraw™ GX 
programming and runtime environments, the relationship 
between QuickDraw GX and the rest of the Macintosh® 
systems software and the relationship between QuickDraw 
GX and Macintosh applications. The key elements of 
QuickDraw GX programming, data structures, object 
types, and functions used most frequently by QuickDraw 
GX developers are also covered. After a general 
introduction, this book provides readers with a series of 
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practical examples demonstrating how to approach 
programming with QuickDraw GX. $24.96 $22.45 


Inside Macintosh®: QuickDraw™ GX 

Typography This book is essential for any 
developer who uses QuickDraw™ GX to manipulate text. It 
shows how to use QuickDraw GX objects to handle all 
kinds of text — from plain, unstyled text to complex, 
mixed-direction and multi-language text with 
sophisticated stylistic and typographic variations. 
QuickDraw GX Typography shows how to create and 
manipulate the three different types of text shapes 
supported by QuickDraw GX including text shapes, glyph 
shapes, and layout shapes. $29-95 $26.95 


Inside Macintosh: QuickTime by Apple 
Computer, Inc. is for anyone who wants to create 
applications that use QuickTime, the system software that 
allows the integration of video, animation, and sounds 
into applications. This book describes all of the 
QuickTime Toolbox utilities. In addition, it provides the 
information you need to compress and decompress 
images and image sequences. $29-98 $26.95 


Inside Macintosh: QuickTime Components 
by Apple Computer, Inc.covers how to use and develop 
QuickTime components such as image compressors, 
movie controllers, sequence grabbers, and video 
digitizers. $84.06 $31.45 


Inside Macintosh: Sound by Apple Computer, Inc. 
describes the parts of the Macintosh system software that 
allow you to manage sounds. It contains information that 
you need to know to write applications and other software 
that can record and play back sounds, compress and 
expand audio data, convert text to speech, and perform 
other similar operations. $26-05 $24.25 


Inside Macintosh: Text by Apple Computer, Inc. 
describes how to perform text handling, from simple 
character display to multi-language processing. The Font, 
Script, Text Services, and Dictionary Managers are all 
covered, in addition to QuickDraw Text, TextEdit, and 
International and Keyboard Resources. $89-96 $35.95 


NEW! Inside Macintosh: X-Ref by Apple 
Computer, Inc. is a fast access to all the 
information in Inside Macintosh. Inside Macintosh X Ref; 
Provides programmers with a quick and easy way to find 
the exact information they need in this definitive suite of 
books, (all 26 volumes). It is indexed by topic, volume, 
chapter, and accompanying page number. $49-06 
$17.95. 


Inside the Macintosh Communi- 

cations ToolBox by Apple® Computer. 
This book is the definitive reference to the Macintosh 
Communications Toolbox, an integral part of the System 
7 Macintosh Toolbox that enables developers to create 
communications applications or add communications 
features to other applications. This book describes all of 
the routines that provide programmers with standard 
access to important communications services and in 
addition enables programmers to extend the reach of the 
Macintosh into non-Apple® environments. $24-06 
$22.45. 


NEW! Macintosh Programmer’s Toolbox 
Assistant CD-ROM Instant electronic 
access to Inside Macintosh essentials. Now Macintosh 
programmers can get quick access to over 4,000 Toolbox 
calls that are at the heart of Macintosh system software. The 
definitions of these data structures, resources, constants, and 
functions are documented in the Inside Macintosh series and 





are essential information for anyone developing Macintosh 
software. Macintosh Programmer's Toolbox Assistant is a 
CD-ROM that harnesses the power of one of the best search 
and viewing engines in the industry. It allows programmers 
to access the Toolbox calls quickly from their development 
environment. With hypertext links allowing programmers to 
view related topics easily. Macintosh Programmer's Toolbox 
Assistant is the ultimate electronic reference tool for 
Macintosh programmers. $99.95 


LANGUAGES 


m EN BASIC for the Newton is 
becue BASIC for the Newton! From NS BASIC 
Corporation, it is a fully interactive 
a implementation of the BASIC programming 
NS BASIC language. It runs entirely on the Newton — 
no host is required. It includes a full set of functions and 
data types, hand-written input, windows, buttons and 
extensions to take advantage of the Newton environment. 
Applications can create files or access the built-in soups. 
Applications can also access the serial port for input and 
output. Work directly on the Newton, or through a 
connected Mac/PC and keyboard. NS BASIC includes a 
150 page pocket sized manual. $99 


CodeWarrior 6" CD by Metrowerks 
comes in two versions — Bronze and Gold. 
These CDs contain the CodeWarrior 6 
@ # & development environment including C++, C 
WN §=and Pascal compilers; high-speed linkers; 
native-mode interactive debuggers; and a powerful new 
application framework called PowerPlant for rapid 
Macintosh development in C++. Bronze generates 680x0 
code. Gold generates both 680x0 and PowerPC code. All 
versions are a 3 CD subscription over a 1-year period. 
Bronze: $99, Gold: $399. Bronze comes with a 6- 
month MacTech subscription. Gold comes with a 
1-year subscription. Both at no additional charge! 


Geekware by Metrowerks is here! In high 
school, they called you a computer geek. Now, 
they work at burger joints and wear 
polyester uniforms. And you don't. Wear 
it to your favorite burger joint. $24.95 











Black Sweatshirts ....... 00... cece eee eee $29.95 
Mousepad ........... cece eee eee eee eee ees $7.95 
Geekware Shirt-Cotton ................0005. $24.95 
Geekware Shirt-Poly .............. ccc ee eee $24.95 
Basal! Cal nic.2srandeosedersdeekeas teas $14.95 
Inside CodeWarrior 6 Book ..............005. $34.95 
Blood, Sweat & Code Black Long Sleeve Shirt . . $19.95 
Cross Platform White Short Sleeve Shirt........ $19.95 
Arnold Black Long Sleeve Shirt ............... $19.95 





SmalltalkAgents”, a 
Superset of the Smalltalk 
language, is fully integrated 
with Macintosh, incor- 
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porating design features specifically for the RISC and 
Macintosh System 7 architecture. SmalltalkAgents is a 
true object oriented workbench that includes an 
incremental and extensible compiler, an array of design 
and cross reference tools, preemptive interrupt driven 
threads and events, an extensive class library including 
classes for general programming, classes for the 
Macintosh user interface and classes for the Macintosh 
operating system. Integration of components in enterprise 
systems is simplified with the network, 
telecommunication, and inter-application communication 
libraries. The SmalltalkAgents’ extensive class library and 
add-on components make it especially well suited as a 
development workbench for custom applications in 
business, education, science, engineering, and academic 
research. $695 
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Symantec C++ for Macintosh is an object 
Oriented development environment designed for 
professional Macintosh programmers. Symantec C++ 
features powerful object-oriented development tools 
within a completely integrated environment. The C++ 
compiler, incremental linker, THINK Class Library, code 
editor with coloring, integrated browser, debugger with 
stack crawl, and automatic project management give 
symantec C++ fast turnaround times. This product 
compiles for both PowerPC and 68K machines. Symantec 
C++ supports multiple editors and translators, so you can 
use your favorite tools and resource editors as well as 
scripts you've written within the environment. And with 
ToolServer, you'll be able to customize menus and attach 
scripts based on Apple events, AppleScript, and MPW 
Tools. The built-in SourceServer provides a source code 
control system, allowing teams of programmers to solve 
tough problems faster. With SourceServer, you'll always 
know you're working on the latest version. And you'll have 
old versions at your fingertips when code “breaks” and 
you need to look back at modifications. $369 


THINK G by Symantec Corporation. THINK C is easy to 
use and highly visual, making it the No. 1 selling 
Macintosh programming environment. Enhancements 
make this product faster and more versatile than ever, 
improving your productivity with more powerful project 
management, a full set of tools, and script support for 
major script-based languages. With the THINK 
environment, you spend less time on routine programming 
tasks due to an extremely fast compiler and incremental 
linker. In addition, the automatic project manager saves you 
time by tracking changes to your files and recompiling only 
those that have changes. All the tools you need — a multi- 
window editor, compiler, linker, debugger, browser, and 
resource editor — are completely integrated for speed and 
ease of use. One of the most valuable of these tools is the 
THINK Class Library, a set of program building blocks 
that gives you a head start in writing object-oriented 
applications. And with the new open architecture, you can 
use your favorite tools, resource editors, and scripts 
within the environment. THINK C is the logical next step 
for programmers who have worked in HyperCard or other 
script-based development environments. The 
environment supports AppleScript, Apple events, and 
Frontier, so you can link and automate complex, multi- 
project operations. Product Contents: Four Macintosh 
disks, an 832-page user manual, and a 568-page THINK 
Class Library Guide. $219 
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THINK Pascal v. 4.0 by Symantec Corporation. 
Professionals and students will welcome this version of 
THINK Pascal. It is fully integrated for rapid turnaround 
time and lets you take advantage of System 7 capabilities. 
Features include support for large projects, enhanced 
THINK Class Library, System 7 compatibility, superior 
code generation, and smart linking. Product Contents: 
Four Macintosh disks, a 562-page user manual, and a 
498-page object-oriented programming manual. $169 


UTILITIES 


NEW! 3D Game Machine v1.1 by Virtually 
Unlimited is a C library for creating lightning- 
fast 3D arcade games and interactive multimedia 
applications. 3DGM has a simple easy-to-use interface 
and features very fast rendering (15 frames per second on 
a 14" monitor completely texture-mapped, with a 
PowerMac 6100/60), full "virtual" 3D worlds with six 
degrees of freedom, free-form texture mapping, shading, 
material and light properties, convex/cave polygons with 
unlimited vertices, unlimited light sources, dynamic 
hidden surface removal, special graphic modes for fast 
full-screen animation, collision detection, explosion 
simulation, 3D data importing. Runs on all Macs! Works 
with CodeWarrior. $299 + license. 


NEW! Animation Class Library version 2.0 

(ACL2.0) is an advanced object-oriented 
mult Tait framework, allowing fast development of high- 
quality interactive applications. Main features of ACL2.0 
are: Powerful animation engine which supports structured 
sprites, collision detection at pixel precision, sprites 
sorting, powerful blitter and vectorobjects. Scrolling of 
background picture in circular buffer and tile- 
mapscrolling. Application framework for building 
standard and 3D controls, panes,menus, full screen 
displays, windows, etc. Quicktime and multi-channel 
soundsupport. >800 functions and >100'000 lines. 
Complete C++ source code for CodeWarrior and 
symantec C++, examples, documentation and technical 
support. $250 


BBEdit 3.1 from Bare Bones Software is now better 
than ever. In addition to being Accelerated for Power 
Macintosh, this powerful, intuitive text editor offers 
integrated support for THINK C 7.0, Metrowerks 
CodeWarrior 6, THINK Reference 2.0 and MPW 
ToolServer. Version 3.1 adds even more capability, 
including “soft” wrapping of text on screen and numerous 
refinements and improvements to the user interface. 
BBEdit’s many features include: Integrated PopupFuncs™ 
technology for speedy navigation of source code files (C, 
C++, Pascal, Rez, 68K Assembler, and Fortran), unique 
‘Find Differences’ command (BBEdit can find differences 
between projects and folders as well as files), support for 
Macintosh Drag and Drop for editing and other common 
tasks, PowerTalk support for reading, sending and 
composition of PowerTalk mail, scripting via any OSA 
compatible scripting language including AppleScript and 
Frontier 3.0, and fast search and replace with optional 
“grep” matching and multi-file searching. BBEdit’s robust 
feature set and proven performance and reliability make it 
the editor of choice for professionals and hobbyists alike. 
$119 


CLimate by Orchard Software is a command line 
interface that lets you communicate with your Macintosh 
using English commands to create, delete, rename, and 
move files and folders. It can start applications, format 
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disks, restart your computer, etc. CLImate supplements 
the Finder. It includes a BASIC interpreter that lets you 
script your Macintosh without AppleScript. The interpreter 
includes advanced programming constructs: repeat loops, 
if/then/else conditionals, subroutine calls, etc... CLImate 
implements wildcard characters, enabling you to work on 
groups of files. Use CLImate instead of MPW to manage 
your projects. CLimate is an application occupying 70K 
disk space. It comes bundled with sample programs and 
full documentation. $59.95 
NEW! Guide Composer™ gives anyone the 
ability to create powerful Apple Guide help 
systems for any new or existing Macintosh application. 
Great for commercial developers, shareware developers, 
in-house developers, and consultants, Guide Composer 
provides a WYSIWYG development environment: Guide 
content is developed in Guide windows. Design topics, 
phrases, and panels in the same format as the user will 
use them. Features are WYSIWYG interface, Topics, 
phrases, and hierarchical phrases, Coach marks, Fully- 
Integrated with Apple’s Guide Maker (distributed with 
Guide Composer), compiles scripts automatically, PICTs 
in Panels, Generated Guide scripts are modifiable, 
Compiled files are 100% Apple Guide-compatible and 
royalty-free. Easy-to-use $99 


CMaster 2.0 by Jersey Scientific installs into THINK C 
9/6/7 and Symantec C++ for Macintosh, and enhances 
the editor. Use its function popup to select a function and 
CMaster takes you right to it. Other features include 
multiple clipboards and markers, a Function Prototyper, 
and a GoBack Menu which can take you back to previous 
editing contexts. Almost all features bindable to the 
keyboard, along over a hundred keyboard-only features 
like “Add New Automatic Variable.” Glossaries, 
AppleScript and ToolServer support, Macros, and External 
Tools you create too! $129.95 


Cron Manager by Orchard Software implements the 
UNIX Cron facility. It can open any Macintosh file on a 
given date and time. By creating an alias, renaming it to 
the date and time to open, and moving it into the special 
Cron Events Folder, Cron Manager will open it. Cron 
Manager is a control panel that creates the special Cron 
Events Folder inside your System Folder. It is completely 
transparent to the user. It works like the Startup Items 
folder, only smarter. It works with any Macintosh file: if 
you can double-click to start it, Cron Manager can open 
it. $26.95. Cron Manager ine with CLImate, $59.95 


dtF is a true relational database system for Apple 
Macintosh computers. dtF provides a powerful choice for 
developers who want to create database centered 
applications with no performance trade-offs. dtF features 
SQL, full transaction control, error recovery, single user, 
Client server architecture and multi-platform support 
including DOS, Windows, OS/2 and UNIX. The C/C++ API 
is identical and fully portable cross all supported 
platforms. Third-party vendors supporting dtF will be able 
to offer a variety of advanced features and benefits to their 
Customers royalty free. Tools are included for importing, 
exporting, creating and managing databases and users. 
Supported development environments include: Symantec, 
MPW, Metrowerks and more. Mac/SDK: $695 


NEW! FaceSpan™ v2 is an extensible Rapid 
Application Designer (RAD) that makes 
building applications quick and easy. It combines an 
interactive, visual interface design environment with the 
object-oriented power of AppleScript or any OSA 
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language. Best of all, FaceSpan allows you to integrate the 
capability of scriptable programs into your custom 
application. Your FaceSpan applications can include any 
number of windows, dialogs, palettes, and menus. In 
them, you can display scrolling lists, popup menus, 
scrolling text, movies, multi-column tables, pictures, 
icons, buttons, and others. While no scripting is needed 
for standard behaviors, every item may have its own 
script. You can even program custom objects using 
Pascal or C. Try the perfect choice for MIS professionals, 
power users, consultants, and programmers @ FaceSpan! 
Includes a royalty-free distribution license, for unlimited 
runtime users, of your FaceSpan-based applications. 
Also included is a FREE UPGRADE to the next version for 
registered users. $199 


InstallerPack™ by StepUp Software is a package of 
several Installer “atoms” that let developers incorporate 
graphics, sounds, file compression and custom folder 
icons into installation scripts. Compression formats 
Supported are Compact Pro & Diamond. Each atom also 
available separately. Compression requires additional 
licensing. $219 


Last Resort Programmer’s Edition records 
every keystroke, command key and mouse event (in local 
coordinates) to a file on your hard disk. This is especially 
useful for program testing & debugging, and for technical 
support and help desks. If something goes wrong 
(because of a power failure, system crash, forgetting to 
Save or deleting lines) and you lose a word, phrase, or 
document you can look in the Last Resort keystroke file 
and recover what you typed. Last Resort is also useful for 
technical support personnel, when they have to ask “What 
was the last thing you did before...?” $74.95 


NEW! LJ Profiler by Lars Jordebo Datakonsult 
Supports profiling of C++ 68K and PowerPC 
applications compiled with CodeWarrior 6, CFront or 
Symantec C++. Based on active profiling, i.e. profiling code 
called at function enter and exit, the browser application 
lets you follow call chain timings in hierarchical views or 
Separate windows. Collect, organize, compare and save 
profiling data from different versions of your application 
into a project. Scriptable and recordable with full access to 
most internal data structures. Optional remote profiling and 
tracking of segment and stack usage. Full source code to 
what you link into your application. $295. 


NEW! LPA MacProlog comprises a Edinburgh 
syntax Prolog compiler system set in an 

attractive multi-window development environment with an 
integrated program editor, graphical call-graph facilities 
and an interactive source-level debugger. LPA 
MacProlog features high-level access to the Macintosh 
ToolBox for using graphics, dialogs, windows, icons, 
resources in a simple and versatile way LPA MacProlog 
also includes interfaces to C and Pascal code resources. 
The MacProlog Run-time Generator enables the 
production of double-clickable distributable applications. 
The compact run-time system supports first argument 
indexing, tail-recursion and last-call optimisation. 
Optional add-ons tools include flex, Prolog++, MacDBI 
for Oracle and the MacProlog Dialog Editor. Programmer 
Edition $745 Developer Edition (which includes the run- 
time generator and distribution licence) $1500 


LS Object Pascal CD includes the world’s first Object 
Pascal compiler for Power Macintosh. 100% compatible 
with Apple's MPW Pascal, LS Object Pascal combines the 
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best of Apple’s native development tools with innovative new 
technology developed at Language Systems. Compiler 
options specify 68K or native PowerPC code generation. 
Included on the CD are: LS Object Pascal compiler, 
Universal Pascal Toolbox interfaces, fully loaded MPW 
3.3.1, 68K and PowerPC source debuggers, PowerPC 
assembler, online documentation, Macintosh Tech Notes, 
and a special version of AppMaker by Bowers Development 
that generates native Pascal source code. The beta release 
includes upgrades to v1.0 when it becomes available. $399 


MacAnalyst/Expert, Demo $79, Product $1595 
MacAnalyst Demo $79, Product $995 MacDesigner/ 
Expert, Demo $79, Product $1595. MacDesigner 
Demo $79, Product $995. By Excel Software. Available. Call 
for more information about these products. 


MacDesigner/Expert by Excel Software supports 
software engineering methods with the capabilities of 
MacDesigner plus multi-task design. An integrated 
requirement database provides traceability from 
requirement statements to design diagrams, code or test 
procedures. This tool is well suited to design or 
maintenance of real-time, multi-tasking software projects. 


MacA&bD by Excel Software combines the capabilities 
of MacAnalyst/Expert and MacDesigner/Expert into a 
Single application. It supports structured analysis and 
design, object-oriented analysis and design, real-time 
extensions, task design, data modeling, screen 
prototyping, code editing and browsing, reengineering, 
requirement traceability, and a global data dictionary. 
Demo $149, Product $2995 


MachTen UNIX for Macintosh and 

Power Macintosh MachTen is a Berkeley UNIX 
that runs on the Classic to the Power Mac, including 
PowerBooks and Duos! So, in addition to all of the 
Macintosh applications, you get a Mach-based UNIX with 
pre-emptive multitasking. MachTen extends the Macintosh 
operating system with UNIX networking and software 
development tools. The Macintosh/UNIX integration is so 
strong that you can even use Macintosh programs and 
utilities on UNIX data, and UNIX programs and utilities on 
Macintosh files. Full internet protocol support ensures fast, 
easy clent and server NFS, e-mail, and file transfer between 
the Macintosh and all TCP-based entities on your network. 
Built-in internet services include domain name service, POP 
mail service, internet routing, SLIP & PPP, and Web service. 
Full X11R5 support with Motif for developing X applications 
and a high performance X server for using your Mac as an X 
terminal. MachTen - Power UNIX $695 Personal MachTen 
(for 68K Macs): $495 Professional MachTen (for 68K 
Macs): $695 MachTen X Window Software: $350. 


MacWireFrame' by Amplified 
Intelligence. Create your own virtual reality 
application with MacWireFrame, a virtual 


reality application frame work. Includes a 
complete library of object oriented graphics routines, its 
own easy to understand application frame work (similar to 
MacApp or TCL but a lot easier to understand), plus an 
example application program that lets you start solid 
modeling right away. Comes complete with fully 
documented source code. All new purchases will be 
guaranteed a $49.99 upgrade to the soon to be released, 
scriptable, MacWireFrame 5.0. Due to the overwhelming 
response the special price offer has been extended for a 
little while longer. Special Offer: $299-00 $75!!!! 


The Memory Mine” by Adianta is a stand alone 


debugging tool for Macintosh and native PowerPC. 
Programmers can monitor heaps, identify problems such 
as memory leaks, and stress test applications. Active status 
of memory in a heap is sampled on the fly: allocation in 
non-relocatable (Ptr), relocatable (Handle) and free space is 
shown, as are heap corruption, fragmentation, and more... 
Allocate, Purge, Compact, and Zap memory let users stress 
test all or part of a program. Source code is not needed to 
view heaps. It works on Macintoshes with 68020 or later 
and System 7.0 or later. $99 


7] PictureCDEF 1.3 by Paradigm 
| Software is a professional-level CDEF 
“ for creating custom graphical buttons 
(8-64 pixels). PictureCDEF is used in products by Adobe, 
ProVue, STF Technologies and others. It is multi-monitor 
and bit-depth sensitive. The button graphic (cicn, ResEdit) 
can be changed at runtime and even animated with a call- 
back routine. Create distinct buttons in seven variations: 
MultiState, PushButton, FlexiButton, ToggleButton, 
ChkButton, PushPictButton and TogglePictButton. Position 
the optional button title at left, bottom or right, or follow the 
system text direction for international support. Manual, 
sample code and MacApp 3.0 support included. Full source 
code: $95.00 Object code: $45.00. 


QC™ by Onyx Technology, is a system extension that stress 
tests code during runtime for common and not-so-common 
errors. Tests include heap checks, purges, scrambles, 
handle/pointer validation, dispose/release checks, write to 
zero, de-reference zero as well as other tests like free 
memory invalidation and block bounds checking. QC is 
extremely user friendly for the non-technical tester yet offers 
an API for programmers who want precise control over 
testing. QC is Also available in Japanese. $99.95 


Q3S/3dPane/SmartPane source code bundle by 
Vivistar Consulting. Q3S: source code bundle from 
ViviStar Consulting. Full featured 3d graphics. Points; 
lines; polygons; polyhedra; Gouraud shading; z-buffering; 
culling; depth cueing; parallel, perspective, and 
stereoscopic projections: performance enhancing 
"OnlyQD" and "Wireframe" modes; full clipping; pipeline 
access; animation and model interaction support; and a 
"triad mouse" to map 2d mouse movement to 3d. 
3dPane provides integration with the TCL and provides 
a view orientation controller. SmartPane provides TCL 
offscreen image buffering, flicker free animation, and 
QuickTime movie recording. SmartPane functions in 3d 
or 2d scenarios. All work with C++ compilers or ThinkC 6 
and compile to PowerPC or 68K target machines. $192 


QUED/M 2.7 by Nisus Software, is a 
programmer's text editor which has defined the industry 
standard for speed and efficiency. With integrated support 
for Symantec C/C++, Metrowerks CodeWarrior 6, and 
MPW, QUED/M offers unrivaled usefulness for the 
Macintosh developer. In addition to supporting all the 
major development environments on the Macintosh, 
QUED/M offers dozens of powerful editing features, 
including unlimited undo and redo, UNIX style GREP 
searching, macro language, scripting, text folding, text 
sorting, file comparison and merging, Toolbox lookup, 
ten editable/appendable clipboards, line numbering, 
markers, displaying text as ASCII codes, vertical and 
horizontal screen splitting, plus much more. $149 


Rosanne™ Rosanne is a collection of 
utilities which offer the user complete control 
over raw data. Users can sort files, extract selected 
records, summarize frequency counts, create sample files, 
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perform matching on multiple files, and reformat data to 
new specifications, all on the desktop, and even on files of 
a million records or more. The Rosanne Utilities also 
support AppleScript™, enabling the user to link several 
actions together to complete an entire process. The 
Rosanne Utilities are recordable; users may perform a 
series of actions, and using an AppleScript editor such as 
Scripter™, see their actions translated directly into 
AppleScript commands. All of the utilities support multi- 
tasking and background processing. The Rosanne Utilities 
will assist you in picking your specifications, determining 
record length, creating output files and managing the 
Storage of data. Rosanne Utilities: Copy — duplicates 
an input file. Format — reates an altered version of an 
input file, containing either subsets of the fields on the 
input file, or new fields. Select — creates a subset of the 
records on an input file based on some selection criteria. 
The Recode option allows the user to group data, or 
correct coding entries. Sort — orders an input file by a 
particular field or set of fields. Match — joins together 
two input files based on common values occurring in 
corresponding fields or sets of fields. Aggregate — 
Creates an output file with summary levels. $595 


NEW! ScriptBase™ The Scripting Data- 
base is a database for storing persistent 
Objects to be made available for access to AppleScript, 
Apple's system-level user scripting language for 
controlling applications on Macintosh® computers. Once 
installed, the database becomes part of the AppleScript 
system, adding a host of commands to the basic 
AppleScript vocabulary. Retrieving the objects is simple 
using AppleScript’s natural-language syntax and 
structure. Objects stored and retrieved in ScriptBase can 
be accessible any time from any script on the user’s 
computer. These objects can be of any type, including 
numbers, character strings, lists, records, scripts, and 
references to disks, files, folders, as well as abstract raw 
data, to name just a few. ScriptBase can be used to 
maintain system-wide settings, such as sets of 
preferences, paths to frequently-used files or folders. 
Complex installations can be made easier by organizing 
data and scripts within the database's structure. $79 


NEW! Script Debugger by Late Night Software 
Ltd. is a powerful and flexible AppleScript 
authoring tool. Script Debugger makes it simple for 
novice and experienced script writers to get the most from 
AppleScript. The program's advanced debugging 
environment offers single-step script execution with 
breakpoints. The Script Debugger dictionary browser 
features a graphical view of objects provided by scriptable 
applications. With the program, you also receive the Late 
Night Software Scripting Additions, a collection of more 
than 70 new AppleScript commands, and Scheduler, a 
utility that allows you to launch scripts at pre-determined 
times. $129 


NEW! Scripter® The Authoring and Development 
Environment for AppleScript™. Scripter, the 
script Construction Set, is the premier comprehensive 
tool for creating and debugging AppleScript scripts. 
Scripter is a shortcut to reaching AppleScript's full 
Capabilities, is both powerful and easy to use. Scripter 
Offers you the power to get the job done. Scripter offers a 
large collection tools to answer the needs of every 
AppleScript user, containing over 25 features. Choose 
Record and Scripter will watch you perform a series of 
actions in recordable AppleScript-savvy applications, and 
translate your actions into a series of AppleScript 
commands. The Builder windows display the range of 


commands available in the specific applications you want 
to use. You can click on commands and parameters to 
assemble your statement, and click to transfer the newly- 
built statement directly into your script. You can build 
references to specify parts of target documents. This will 
Save you time, aS you won't have to guess how to refer to 
a specific command or object — Scripter does it for you. 
Many time-savers are available to assist you in writing 
your scripts faster, providing relief for certain constructs 
which are tedious or repetitive. Scripter includes a six- 
function search-and-replace capability. Included are 
several tools which facilitate the process of debugging 
scripts. The Observe window lets you watch the status 
of variables as they change. And the biggest news is the 
Debugger, which allows you to see exactly what's going 
on, as it happens! The most eagerly awaited feature is 
Debugging. Scripter is the only true AppleScript debugger 
available anywhere. $199 


ScriptGen Pro™ by StepUp Software is an Installer 
script generator which requires no programming or 
knowledge of Rez. Supports StepUp’s InstallerPack, Stuffit 
compression, custom packages, splash screens, network 
installs, Rez code output, importing resources, and 
AppleEvent link w/MPW: $169 


Spellswell 7 1.0.4 is an award-winning, 
comprehensive, practical spelling checker that works in 
batch mode or within applications that incorporate the 
Apple Events Word Services protocol (e.g., Eudora, 
WordPerfect, Communicate!, and Fair Witness). 
Spellswell 7 checks for spelling errors as well as common 
typos like capitalization errors, spaces before punctuation, 
double double word errors, abbreviation errors, mixed 
case errors, extra spaces between words, a/an before 
vowel/consonant, etc... MacTech orders include developer 
kit with Writeswell Jr., a sample Apple Events Word 
Services word-processor and its source code. $74.95 


Spyer by InCider is a simple operated tool that records 
all actions (including mouse movement) you perform on a 
Macintosh computer and then replays them at your 
preferred speed. The recorded data can be saved in files 
for future use. Spyer works as a background process with 
any Macintosh application and is triggered by user 
defined Hot Keys. Spyer enables the “Continuous Redo” 
utility and is especially useful for software testing and 
demonstration. $39 


StoneTable: A library replacing all functions found in 
list manager plus: variable size columns/rows; different 
font, size, style, forecolor, backcolor per cell; sort, resize, 
move, copy, hide columns/rows; edit cells/titles in place; 
titles for columns/rows; multiple lines per cell: grid line 
pattern/color; greater than 32k data per table; up to 32k 
text per cell; support for balloon help and binary cell data. 
Versions for Think C, Think Pascal, MPW C, MPW 
Pascal, CodeWarrior 6 C. (all prices per developer) $150 
first compiler, additional compilers $50 


StoneTable and StoneTableExtra for 
PowerPC: Same functionality as 68K libraries. 
Versions for MPW C and CodeWarrior 6 C. Must have 
68K libraries. (all prices per developer) StoneTable $100, 
StoneTableExtra $25 


StoneTable Extra: Additional functions for 
StoneTable. Drag selected cells within table or to other 
tables; optionally add rows as part of drag; popup menus 
or check boxes in cells; variable width grid lines; 
move/drag/resize table in window; clipboard operations 
on multiple cells. Requires StoneTable. (all prices per 
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developer) $50 first compiler, additional compilers $25 


NEW! TCP/IP ae Addition” is the 
latest version of an award-winning AppleScript 
scripting addition (first place in the 1994 “Best Hack” 
category in the Everyday AppleScript” Programming 
Competition). This scripting addition (or osax) allows you 
to write scripts using MacICP™ commands in 
AppleScript". Potential uses of this include sending e- 
mail or files through a script, checking if users are logged 
On (via Finger), automating FTP, Gopher, NetNews, 
Telnet, and LPR, verifying links in HTML documents, and 
quickly writing many other TCP/IP client-server 
programs. Sample scripts are included already 
implementing many of these functions. When combined 
with FaceSpan, the potential for rapid implementation of 
Internet client-server applications is enormous. The 
TCP/IP Scripting Addition works with AppleScript 1.0 or 
later and MacICP 2.0.4 or later. It is compatible with 
Open Transport™. The TCP/IP Scripting Addition can be 
used from Script Editor, HyperCard 2.2, MacPERL, 
FaceSpan and other Open Scripting Architecture 
applications. 

See “http://www.mangotree.com/biz/mango/index.html” 
for more details. $49 


Voodoo is a version control tool for the simple 
and clear management of projects in which 
files are created in numerous versions (variants and 
revisions). Voodoo allows both variant and revision 
control, and it manages not only variants and revisions of 
single files, but of a whole software project (multi files, 
multi users, multi variants, access rights, ...). The tool 
offers a neat graphical user interface and is not only 
Suitable for mere source code control but can handle all 
different kinds of files with amazing compression rates: 
typical size of delta between arbitrary files 5% (in words: 
five per cent) !!!! no matter whether the files are plain text 
or any other documents — e.g., MSWord, 4D, Canvas, 
vay o _ FileMaker ...). Please note special prices 
.. for multiple copies. single license — $ 
190 2 pack —$ 300 5 pack — $ 665 
10 pack — $1140 20 pack — $ 2000 
_ Add'l pricing available on request. 
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Tip of the Month continued from page 104 


} 
// APPLICATION FRAGMENT 
OSErr TogglePatch(Boolean engage) 
{ 
OSErr erroz=3DnoErr; 
long gestaltFeature=3D0; 


//this call switches the = patch status 
error = 3DGestalt (kPatchSelector, &gestaltFeature) ; 


if (engage) { 

// was = already engaged; turn it back on 

if ((errcr = 3D = 3DnoErr) && 

(gestaltFeature = 3D = 3DkPatchNotPresent) ) 

error = ‘DGestalt(kPatchSelector, &gestaltFeature) ; 
} 
else { 

// was = already disabled; turn it back off 

if ((error=3D=3DnoErr) && 

(gesta_tFeature=3D=3DkPatchPresent) ) 

error=3DGestalt(kPatchSelector, &gestaltFeature) ; 

} 


return errcr; 


— Luigi Belverato 
Milano, Italy 


HandleMenuhoice continued from page 104 


With this code, if the user selected an item in a submenu of 
the apple menu, the system will switch to the Finder and open the 
selected item (thanks to Apple Menu Options). When you switch 
back to your application, the apple menu will still be hilited (even 
if you call DrewMenuBar on the switch). 

The work around is simple, call HiliteMenu( 0 ) even if 
MenuSelect returns OL. 

HandleMenuChoice should look like this: 


void HandleMeiuChoice( long menuChoice ) 
{ 

short ment; 

short item; 


if ( menuChoice != OL ) { 
menu = HiWord( menuChoice ); 
item = LoWord( menuChoice ); 


switch ( menu ) { 
case mApple: 
HancleAppleChoice( item ); 
breck; 
case mFile: 
HancleFileChoice( item ); 
breek; 
// Otter menus 
} 
// HiliteMenu( 0 ) was here 
} 
HiliteMenuf 0 ); 
} 


// moved it to here 


Your code may not look anything like this, but the idea is to 
call HiliteMeru( 0 ) even if MenuSelect returns OL. 


— Don Bresee 
Los Angeles, CA 
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THE Lost PAPER 

True story: I was once typing in some text in a word processor, 
when the computer suddenly crashed on me. I didn’t save a copy 
on to the hard-disk yet. I had to restart the computer and type it all 
over again. “But wait, the paper is still in the machine” I thought to 
myself. You see, when you restart all of the computer’s memory 
doesn’t get cleared, it just stays to what it was until it gets replaced 
with other information (usually, much like the behavior of a hard- 
disk). I had one thing going for me, I had MacsBug installed. Here 
are the steps I took to recover the paper: 

First, I logged all of the work I was doing in MacsBug to a file. I 
did this using the “log” command. All you need to give the command 
is the name of the new file to log to. I named it “MyPaper” Good, 
now all of my MacsBug session will be on the hard-disk, so I can 
open it up with a normal text editor when I’m done. 

Next, I needed to find where in memory my paper was. I did this 
using the “f’ command. The first two parameters for this command is 
the range in memory in which you want MacsBug to search through. I 
wanted to search through all of my memory, which is 8 megs, so I 
typed in: “f 0 (400 * 400 * 8) “any string””. Where 0 is the beginning 
of memory and 8 megs is the top of it. The last parameter is the search 
string, balanced between two single quotes. I wanted to pick a distinct 
string, otherwise I would have hit other parts of memory that had it 
too, making the process take longer. I knew the word aardvark was 
mentioned in my paper, so I typed in this for the find command: 


f 0 (400 * 400 * 8) “aardvark” 


MacsBug then started searching for me. It came up with a small 
memory dump of something with the word arrdvark in it, but the 
words after it were not mine. (Which meant that I found another part 
of memory instead of my paper.) I then hit return to tell MacsBug to 
keep on searching. It then came up with a dump from my paper: 


Searching for “aardvark” from 00000000 to OO/FFFFF 
00358200 6161 7264 7661 726B 8000 0000 0000 002C 
aardvark answer, 


Which was very good news indeed! This told me that the 
string “aardvark answer” could be found at address 00358200. (I 
got this address from the leftmost number given.) 

Now that I knew where it was, the rest my task would be easy. 
I used MacsBug’s display memory ASCII command to show me what 
came after it, by typing in: “dma 00358200”. (You might not have this 
command, in which case you'll have to use plain old dm, instead of 
dma.) I hit return until my paper was done being displayed. 

Note: You can subract a number from the address to see what 
was before it. For instance, subracting #200 from an address will 
give you the address of the first byte of the 200 byte block before it. 

I then typed in “log” again, which closed my log. I finally 
went out of MacsBug and opened the log file with SimpleText. 
Remember, the log had my whole session, not just the paper, so I 
had to delete the addresses and such from it, (which really isn’t 
that hard to do, if you know how to use your mouse and your 
delete key efficiently). The paper was saved. 

Warning: In your search you might stumble upon MacsBug’s 
very own memory, with its own copy of your search string. To get 
out of this recursive loop, start the search over again with the base 
search address being outside of MacsBug’s memory. 


— Macneil Shonle 
Yarmouth Maine, MacneilS@aol.com 
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HANDLEMENUCHOICE 


This tip may be a little obvious, I caught it right away, but 
some people may not have noticed the problem yet. Some people 
may have coded around it to begin with, but I didn't. 

System 7.5 was the first time I saw the "Apple Menu Options" 
control panel. It is an extremely useful tool, I love it and use it 
constantly. But, there may be a slight difference in the way your 
application needs to handle menu highliting now that this control 
panel exists. 

Here is the assumption I had been making for a long time: 
When the user selects a menu item, MenuSelect (and MenuKey) 
leave the menu title hilited. The application performs the indicated 
action and then unhilites the menu title. When no menu item is 
selected by the user (MenuSelect or MenuKey return OL), the menu 
titles are not left hilited after the call. 

The Apple Menu Options control panel is an exception. A 
menu selection in a submenu of the apple menu will leave the 
apple menu hilited, but MenuSelect will return OL. 

In the event handling code I have calls like this: 


HandleMenuChoice( MenuSelect( event->where ) ); 
HandleMenuChoice( MenuKey( event->message & charCodeMask ) ); 


HandleMenuChoice looked like this: 


void HandleMenuChoice( long menuChoice ) 
{ 

short menu; 

short item; 


if ( menuChoice != OL ) { 
menu = HiWord( menuChoice ); 
item = LoWord( menuChoice ); 


. 


switch ( menu ) { 
case mApple: 
HandleAppleChoice( item ); 
break; 
case mFile: 
HandleFileChoice( item ); 
break; 
// Other menus go here. 
} 
HiliteMenu( 0 ); 


Continued on page 101 











end us your tips or we'll install EvenBetterBusError on 
our machine! On the other hand, we might just pay you 
$25 for each tip we use, or $50 for Tip of the Month. You 
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Agents Object System 
MACINTOSH 


SmalitalkAgents v2.0 


SmalltalkAgents® (STA) is a sophisticated application 


Agents Object System 
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Agents Object System 


The Agents Object System™ (AO/S) is an underlying task 

























development environment featuring a new generation of the framework, housing components and services that save 


Smalltalk language, QKS Smalltalk." Productivity is no longer you years of work. It is the foundation of the QKS Product 


measured in lines of code, but in project completion time. Family, and includes significant features that exist now in 
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“Hot” Devel opment: commercial form over the next 12 months. 


Creative, Fluid, Productive 











Task Frameworks and Services 


The AO/S is a value-added collection of “components” and 





STA allows “live” direct manipulation of your objects. 








The development process is dynamic, interactive, and itera- “services” embedded in SmalltalkAgents and VisualAgents, 


tive. Our dynamic GUI Builder enables “live” real-time cre- and optionally available for distribution with your 






applications. AO/S Services include: 
* Client/Server Cyberspace engine (TCP/AP, WWW, Email) 
¢ DTP/word processing engine (> 32K styled text, full 


ation and manipulation of objects and code. 
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“No Compromise” 
Access to the Metal 
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° Database collaboration engine 
* Distributed objects (like DSOM) 
° Full-featured Smalltalk compiler 






Just like C/C** and Assembly, STA provides easy and full 
access to the features of the MacOS™ and Mac Toolbox. 







You can link in your non-Smalltalk code resources using our 
External Code Linking Toolkit (ECLT"™). You can also 
call back into STA from foreign functions written in C/C**, 


* Cross-platform frameworks and components 









OpenDoc Integration for Free 


Any component built in AO/S will function as an 






Pascal, Fortran, and Assembly. 






OpenDoc component or container, and components 






Application Delivery Toolkit 


from different (non-AO/S) sources can be leveraged by 






seamlessly integrating them into the AO/S system, regard- 






STA includes an Application Delivery Toolkit’ (ADT) that 
allows you to create royalty-free, stand-alone, double- 
clickable applications in just a matter of minutes. 


1-800-296-1339 
info@qks.com or http://www.qks.com/ 
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Quasar Knowledge Systems, Inc. 
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Bethesda, MD 20814 USA 

Tel: (301) 530-4853 Fax: (301) 530-5712 
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Twelve Compilers! 68K Mac and Power Mac. The same 


CodeWarrior Gold includes 12 compilers and interface compiles 68K or PPC code. 






Bronze includes 6 compilers. With our Power 
Mac-hosted 68K cross compilers, you can build 
both 68K and Power Mac apps on the Power 


Mac. Conversely, with our 68K Mac-hosted 








Power PC cross compilers you can build 68K ae of onflifte documentatfon 


and Power Mac apps on a 68K Mac. t (w gis’ n). 


Native IDE’s! 


The CodeWarrior integrated development 












e Object Pascal 
environment (IDE) is native on both the ¢(++ Exceptions & Browser 





CodeWarrior 6 Gold 
For PPC & 68K Macintosh $399 


¢ Support for STL 
* Drop-In Tools Environment 


CodeWarrior 6 Bronze 
For 68K Macintosh $99 


*Raw Memory Hex Dump 
¢ Online Reference in QuickView 


30-Day, Money-Back Guarantee. 
2 free updates, with registration. 


¢ Easy Access To Toolbox Assistant 





Native Magic Cap development environment for PowerPC and 68K 





CodeWarrior Magic is a Macintosh-hosted toolkit for Magic Cap application development. 
The CodeWarrior Magic/ MPW toolkit includes General Magic’s object-oriented development 
tools as well as Metrowerks production-quality tools. Programmers proficient in C can 
develop and debug on a Macintosh and then download applications to a Magic Cap personal 


communicator for final debugging. A Magic Cap simulator for Macintosh is included. 





CodeWarrior Magic : +3 Free Updates 
For Power Macintosh & G86... o.oo. cc cccccccceccccccecesecescssucsesccceecvsceceecsaccesecccescessiess $299 





For more information: « Metrowerks e (512) 346 1935 esales@metrowerks.com To purchase: « Metrowerks Mail Order 800-377-5416 





